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FCC Note The Specialix JETSTREAM 4000, JETSTREAM 8500 and 

LANSTREAM 2000 products have been found to comply with the limits 
for a Class A digital device, pursuant to Part 15 of the FCC rules. These 
limits are designed to provide reasonable protection against harmful 
interference when the equipment is operated in a commercial 
environment. This equipment generates, uses and can radiate radio 
frequency energy and, if not installed and used in accordance with the 
instructions in this Guide, may cause harmful interference to radio 
communications. Operation of this equipment in a residential area is 
likely to cause harmful interference, in which case the user will be 
required to correct the interference at his/her own expense. 



EN 55022: 1998, Class A, Note 



WARNING This is a Class A product. In a domestic environment this product 
may cause radio interference in which case the user may be required to take 
adequate measures. 



C € Caution: the JETSTREAM 4000, JETSTREAM 8500 and 

LANSTREAM 2000 are approved for commercial use only. 
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About this Guide 

This guide describes how to configure the JETSTREAM 4000, 8500 or LANSTREAM 2000, using a text- 
based terminal or terminal emulator. It is intended for a network systems administrator, familiar with UNIX 
operating systems and Ethernet TCP/IP networks and, possibly, the RADIUS protocol. 

Please note this Guide describes menu functions in the text-based menuing system (also named 'Full 
Screen Menus' or 'fsm'), thus: 





SLIP line 1 


Local IP 


[ ] Remote IP [ ] 


Addr e s s 


addr e s s 


Subnet Mask 


[ ] [ ] 


Max TX unit 


[ ] Suppress ICMP [ ] 


Interact ive 


[ ] VJ_comp [ ] 


Priority 




TX parameters 


[ ] 



However, all configuration parameters described in this Guide are the same parameters seen in JETset, the 
web-based graphical configuration utility. 

Some chapters deal separately with the terminal server and remote access functions. The appendixes are 
common to both functions. 

Note 

1 . There is a separate JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide. 

2. For those familiar with the product range there is a Quick Start Guide; this is a small folding leaflet 
which is packed with the product. 
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Chapter 1 Configuring a Line: 
Terminal Server Connections 



Contents 

• Introduction 

• Telnet/Rlogin into the unit 

• Starting Telnet/Rlogin from the unit 
' Login direct to host 

' Login for Sessions 

' Copy settings to other lines 

• Reset Serial Line to Default 
' Save to non-volatile memory 
' Reverse Telnet connection 

For remote access connections using SLIP and PPP see Chapter 3 Configuring a Line: - SLIP and PPP 
Connections. 

Note For an overview of all line types (including those discussed in other chapters in this manual) see Appendix 

A (Summary of Line Service Types). 



Introduction 

A terminal server connection allows a user or users to send and receive characters to/from a local host(s). 
This type of connection is useful for users who need to access an account on a host running TCP/IP. Those 
users will most likely be using a dumb terminal. 

You will see that the JETSTREAM 4000, 8500 or LANSTREAM 2000 is called the 'unit'. The use of the 
word 'unit' avoids frequent repetition of the product name. 

Tip The unit is primarily for remote access connections (using SLIP or PPP). For terminal server type 

connections we recommend that you change the default settings for the user parameters 'idle timer ' and 
'session timer '. By changing the settings you will tune the unit for terminal server connections. See Section 
Configure a User Account, sub-sections 'idle timer ' and 'session timer '. 
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Telnet/Rlogin into the unit 



You can telnet/rlogin into the unit from another computer on the local network (see Figure 1). For example 
you may wish to configure the unit and you prefer to do this across a network. 

To set up the unit so that you (as system administrator) can telnet or rlogin into it, configure the following: 
- use your own account (username 'admin') and use/set user 'service' to 'jsprompt'. 

To set up the unit so that a user can telnet or rlogin into it, configure the following: 
configure a user account and use/set user 'service' to 'jsprompt'. 



Figure 1 



Telnet/rlogin into the unit. 



Server (host) 



RADIUS 
host 



network 



through a network port 
the Specialix unit will 
offer a login prompt to 
an hogin/telnet request 

make sure the service 
for the user is set to 
'jsprompt' - so after 
authentication he/she/you 
will see the login prompt: 
relevant for your unit, 
for example, 'js_8500' 



JETSTREAM 

(any model), 
or LANSTREAM 



Notes on telnet/rlogin into the unit: 



telnet or 
rlogin 




telnet or rlogin from this 

computer 
into the Specialix unit 



1 . You cannot configure the line parameters when you/the user are accessing the unit via one of its 
network ports on a telnet/rlogin connection. Parameters such as 'terminal type' are negotiated 
automatically between the computer and the unit. 

2. only two users can telnet into a unit simultaneously 

3. there are no timeouts; the session is open permanently, until you reboot or logout. 

16 
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For infonnation on RADIUS authentication when telnet/rlogin are used, see Telnet/Rlogin and RADIUS on 
page 20. 



Starting Telnet/Rlogin from the unit 



You or a user may need to telnet/rlogin from the unit to another device. The method is to login to the unit 
and then be presented with the telnet/rlogin service from the unit. (As the system administrator you may 
wish to be presented with the command line prompt and then to manually start a telnet/rlogin session to the 
other device). We envisage that you will be connected to the unit via a serial line directly (or with a 
modem) into one of its front-mounted serial ports; see Figure 2. 



Figure 2 



Starting Telnet/Rlogin from the unit 



Server (host) 



RADIUS host 



telnefor riogin 



r 



configure a user 
account with 
user 'service' set to 
'telnefor 'riogin' 
(you may wish to keep 
the 'admin' user account 
with user service set to 
'jsprompf) 

use/set default 
line 'service' 
of'jslogin' 



in the Specialix unit 
set 'dial' to 'in' 
for the port to which 
this modem/ISDN TA 
is attached. 



t 



JETSTREAM 
(any model), 
or LANSTREAM 



you/user see(s) 
a login 
on the 

Specialix unit 



local dumb 
terminal 



you/user sees a 
login on the 
Specialix unit 



modem 
or 

ISDN TA 




ISDN TA 



remote 

dumb 

terminal 



As the system administrator (username 'admin') you may wish to keep your own user 'service' as 
'jsprompt' (after authentication you are presented with the unit command line prompt). 
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For a user you may prefer to configure the line so that he/she by-passes the unit and logs in directly on a 
host; if so, see Login direct to host on page 20. If your user needs to connect to several hosts - possibly 
simultaneously - you may prefer to configure sessions for him/her; if so see Login for Sessions on page 24. 

To set up this type of connection configure the following: 

cli syntax 1 . Select 'Line Settings' from the Line Configuration menu, then select a particular line; e.g line 4. The 

set line, following form will be displayed (default values): 

show line 



seru iceU ffSBEHi 

speed[9600 ] 
f 1 owCnone ] 
bitsCS] 
pari tyCnone] 
stopCl] 
securi ty[off ] 

dialCnone ] 
phone numberC 

idle timerC 



terminal [dumb 
pages [4] 
user [ 
hostnametsco 
host portE23 
JS port[23 

modem name none 
] session t imer[ 



2. Go to the following fields: 



Service 



use/select the default line service of 'jslogin' login. 



Speed, Flow, Bits, Parity and Stop 



Terminal 



User 



Hostname 



Host Port 



Dial 



change from the default line configuration of 9600 baud, software flow control, 8 data 
bits, no parity and 1 stop bit. 

check the type of terminal which you will attach to this particular line, then select one of 
Wyse 60, ANSI or VT100. You can download additional terminal definitions, when you 
can use terml, term2 or term3; refer to Downloading Terminal Definitions on page 96. 

this field allows you to define the name of the user of the line. On rlogin connections 
(direct rlogin and silent rlogin), this field is mandatory because the user name is always 
passed to the UNIX host under the rlogin protocol. (On line service types 'jslogin', this is 
an option, enabling you to dedicate the line to a specific user. This user won't be prompted 
for their user name, just their password.) To select a user you must first add that user to 
the user table in the unit. See Section Add a User Account. 

use the spacebar to cycle through the available hosts. Select the host that you want the user 
to log into. By default, the hostname field displays 'none' because there are no hosts in the 
host table; after you have entered hosts in the host table the 'hostname' field defaults to 
the first host in the host table. 

by default, the Host (TCP) Port is set to 23 (telnet). In most cases you can use 23 for both 
telnet and rlogin. 

if your user is remote and he/she will be dialling in via modems/ISDN TAs set this field 
to 'in' 



cli syntax: 
add modem 



3 . Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

4. If your user is remote and will be dialling in via modems/ISDN TAs (more actions): 

Go to the Line Configuration Menu: 
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a) , select 'Modems' then select 'Add Modem'. Enter the name of the modem/ISDN TA 
attached to the unit. You can enter a maximum of twenty names, each with nineteen 
alphanumeric characters. 

b) . from 'Modems' select 'Change Modem'. Select your modem/ISDN TA name. Enter 
the initialisation string; see your modem/ISDN TA documentation. 

Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

set line Go back to the 'Line Settings' menu. Select your line. When the line parameters form 

appears go the field 'modem name'. Press 'L' (upper or lower case) or the spacebar. 
Choose the modem name which you entered at Step 4. 

5 . Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

idle timer (you may wish to change the default value) enter a period in seconds for which the idle 

timer will run. Use this timer to close a connection because of user inactivity. When the 
idle timer expires the unit will end the connection. The default value is 300 seconds, 
meaning the idle timer will expire 300 seconds after the last user activity. The maximum 
value is 4294967 seconds (equal to 49 days, approximately). A value of 0 (zero) means 
the idle timer will not expire so the connection is open permanently. 



Caution In addition to this line idle timer, you can configure an idle timer associated with a particular user. The user idle 

timer will override the line idle timer. See Section Configure a User Account. 



session timer (you may wish to change the default value) enter a period in seconds for which the session 
timer will run. Use this timer to forcibly close a user's session (connection). When the 
session timer expires the unit will end the connection. The default value is 0 (zero), 
meaning that the session timer will not expire (the session is open permanently, or until 
the user logs out). The maximum value is 4294967 seconds (equal to 49 days, 
approximately). 



Caution In addition to this line session timer, you can configure a session timer associated with a particular user. The 

user session timer will override the line session timer. See Section Configure a User Account. 



6. Ignore the other fields in this form. Press <return> to exit; if you do not wish to save your changes 
press the <escape> key. 

You can copy the settings for this line to all other lines; refer to Copy settings to other lines 
on page 26. 

You can reset this line to default (an option as you exit this form); refer to Reset Serial 
Line to Default on page 27 

changes to a line will take effect the next time the user logs in. The exception is the 'terminal' parameter 
where the change will take effect immediately. 

You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

For information on RADIUS authentication when telnet/rlogin are used, see Telnet/Rlogin and RADIUS on 
page 20. 

You may now need to configure a user account. Refer to Section Add a User Account. 



Note 

Tip 
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Telnet/Rlogin and RADIUS 

This section explains about RADIUS authentication of users when they are using the telnet/rlogin programs 
with the unit. 

1. When you telnet/rlogin into the unit from another computer across a network (as shown in Figure 1): 

- all users will always be authenticated by the unit - the 'authentication' setting is ignored. 

2. When you/a user connect(s) to the unit with the intention of starting a telnet/rlogin connection to 
another device (as shown in Figure 2): 

- the user with username 'admin' will always be authenticated by the unit - the 'authentication' setting 
is ignored 

- any other user can be authenticated by the unit or by RADIUS - the 'authentication' setting is observed 



Login direct to host 

To setup users so that they are presented with a login directly on a host machine, bypassing the 
JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit'), you will need to set up 'direct' or 'silent' 
connections. This scenario is shown at Figure 3. 
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Figure 3 Connections directly on a host (bypassing the unit) 



Server (host) 



set 'line service' to, 
direct telnet 
siient telnet 
direct rlogin 
or 

silent rlogin 

configure a 
user accout 
for direct or 
silent rlogin 
only 



in the 

Specialix unit 
set 'dial' to 'in' 
for the port to which 
this modem/ISDN TA 
is attached. 



JETSTREAM 
(any model), 
or LANSTREAM 




local dumb 
terminal 




ISDN TA 



user sees a 
login on the 
server [host] 
- not the 
Specialix 
unit 



remote 

aumb 

terminal 



Authentication of the user is done by the host, using its own table or RADIUS information. 

cli syntax: 1. Select 'Line Settings' from the Line Configuration menu, then select a particular line; e.g line 2. The 

set line, following form will be displayed (example settings): 

show line 



seru i ce[ 



speed[9600 ] 
f 1 owCnone] 
bitsCS] 
pari tyCnone] 
stoptl ] 
securi tytof f ] 

dialCnone ] 
phone numberC 

idle timer[1800 



terminal [wyse60] 
pages [4] 
user [ 
hostname [sco 
host port[23 ] 
JS port[23 ] 

modem name none 



] session timer[28800 



2. Go to the following fields: 
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Service use the spacebar to select one from direct telnet, direct rlogin, silent telnet, silent rlogin (or 

press 'L' (upper or lower case) to display a list). 'Direct' connections are temporarily 
established on the host, 'silent' connections are permanently established. Silent 
connections will consume system resources even when not in use. 

For a fuller explanation of direct and silent see Section Definitions of Direct and Silent. 

For an explanation of the telnet and rlogin see Section Merits of Telnet and Rlogin 



By default, the line service is JS (JETSTREAM) login 

Speed, Flow, Bits, Parity and Stop 

change from the default line configuration of 9600 baud, software flow control, 8 data 
bits, no parity and 1 stop bit. 

Terminal check the type of terminal which you will attach to this particular line, then select one of 

Wyse 60, ANSI or VT100. You can download additional terminal definitions, when you 
can use terml, term2 or term3; refer to Downloading Terminal Definitions on page 96. 

User this field allows you to define the name of the user of the line. On rlogin connections 

(direct rlogin and silent rlogin), this field is mandatory because the user name is always 
passed to the UNIX host under the rlogin protocol. (On line service types 'jslogin', this is 
an option, enabling you to dedicate the line to a specific user. This user won't be prompted 
for their user name, just their password.) To select a user you must first add that user to 
the user table in the unit. See Section Add a User Account. 

Hostname use the spacebar to cycle through the available hosts. Select the host that you want the user 
to log into. By default, the hostname field displays 'none' because there are no hosts in the 
host table; after you have entered hosts in the host table the 'hostname' field defaults to 
the first host in the host table. 

By default, the Host (TCP) Port is set to 23 (telnet). In most cases you can use 23 for both 
telnet and rlogin. 

If your user is remote and will be dialling in via modems/ISDN TAs, set the Dial field to 
'in'. 



Host Port 
Dial 



Note that with the direct and silent line services, the unit performs no modem/ISDN TA 
configuration or initialisation . You must configure the modem/ISDN TA before 
connecting it to the unit. Modems must be set to AUTO-ANSWER mode. In this form 
ignore the 'modem name' and 'phone number' fields. 

idle timer (you may wish to change the default value) enter a period in seconds for which the idle 

timer will run. Use this timer to close a connection because of user inactivity. When the 
idle timer expires the unit will end the connection. The default value is 300 seconds, 
meaning the idle timer will expire 300 seconds after the last activity. The maximum value 
is 4294967 seconds (equal to 49 days, approximately). A value of 0 (zero) means the idle 
timer will not expire so the connection is open permanently. 



Caution In addition to this line idle timer, you can configure an idle timer associated with a particular user. The user idle 

timer will override the line idle timer. See Section Configure a User Account. 
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session timer (you may wish to change the default value) enter a period in seconds for which the session 
timer will run. Use this timer to forcibly close a user's session (connection). When the 
session timer expires the unit will end the connection. The default value is 0 (zero), 
meaning that the session timer will not expire (the session is open permanently, or until 
the user logs out). The maximum value is 4294967 seconds (equal to 49 days, 
approximately). 



Caution In addition to this line session timer, you can configure a session timer associated with a particular user. The 

user session timer will override the line session timer. See Section Configure a User Account. 



3. Ignore the other fields in this form. Press <return> to exit; if you do not wish to save your changes 
press the <escape> key. 

You can copy the settings for this line to all other lines; refer to Copy settings to other lines 
on page 26. 

You can reset this line to default (an option as you exit this form); refer to Reset Serial 
Line to Default on page 27 

Note changes to a line will take effect the next time the user logs in. The exception is the 'terminal' parameter 
where the change will take effect immediately. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

You may now need to configure user accounts. Refer to Section Add a User Account. 



Definitions of Direct and Silent 

Direct connections bypass the unit enabling the user to log straight into a specific host. A direct connection 
is recommended where a user logging in to the unit is not required. It is also recommended where multiple 
sessions are not a requirement. The message 'Press return to continue' is displayed on the user's screen. The 
user must hit a key to display the host login prompt. The message is redisplayed on logout. 

Silent connections are the same as direct connections except that they are permanently established. The host 
login prompt is displayed on the screen. Logging out redisplays this prompt. Silent connections, unlike 
direct connections, however, make permanent use of pseudo tty resources and therefore consume host 
resources even when not in use. 



Merits of Telnet and Rlogin 

You can select the telnet or rlogin protocol for direct and silent connections. If unsure which to use, 
consider the following: 

• Telnet can be used to access both UNIX and non-UNIX hosts; rlogin can normally only be used with 
UNIX hosts. 

• Telnet provides more options for connecting to hosts, but rlogin uses fewer system resources. 
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Rlogin passes your user name and a terminal type to the host. On some older versions of SCO UNIX, 
however, these may not be passed. Failure to pass the terminal type results in your TERM variable 
being set to 'unknown' upon login. 



Login for Sessions 



You can configure lines so that users login to the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 
'unit') and then start a session or multiple sessions - via telnet or rlogin - on a host or hosts local to the unit. 
The session(s) are setup inside the unit; see Figure 4. 



Figure 4 



sessions on one or more servers (hosts), set up within the unit. 



servers (hosts) 



- 



JETSTREAM 
(any model), 
or LANSTREAM 



set 'line service' to 
jslogln 

configure a 
user accout(s) 
and set 
'user service' 
to jsprompt 



in the 

Specialix unit, 
enter the modem/ 
ISDN TA name and 
initialisation string; 
also set 'dial' to 'in' 
tor the port to which 
this device 
is attached. 



user sees 
a login 
on the 

Specialix unit. 
User then starts 
a session(s) on 
the server (host) 
or servers (hosts) 



RADIUS 
Server 



in the 

Specialix unit 
you can set 
authentication 
to happen here 



local dumb 
terminal 



modem 
or ISDN TA 




modem 
or ISDN TA 



user sees o 
login on the 
Speciaix unit. 
User then starts 
a session(s) on 
the server (host) 
or servers (hosts) 



remote 

dumb 

terminal 



Authentication of the user is done firstly by JETSTREAM 4000, 8500 or LANSTREAM 2000, then by 
each host into which the user logs. 
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cli syntax: 
set line, 
show line 



To configure a port so that users login to the unit and start session(s) on a local host(s) do the following: 

1. Select 'Line Settings' from the Line Configuration menu, then select a particular line; e.g line 4. The 
following form will be displayed (example settings): 



speed[9600 ] 
f 1 owCnone ] 
bitsCS] 
pari tyCnone] 
stopd] 
securi tyCoff ] 

dialCnone ] 
phone numberC 

idle timerC 



terminal [dumb 
pages[4] 
user [ 
hostnametsco 
host portE23 
JS port[23 

modem name none 



] session t imer[ 



2. Go to the following fields: 

Service select 'jslogin'. 

Speed, Flow, Bits, Parity and Stop 

change, if necessary, from the default line configuration of 9600 baud, software flow 
control, 8 data bits, no parity and 1 stop bit. 

Terminal check the type of terminal which you will attach to this particular line, then select one of 

Wyse 60, ANSI or VT100. You can download additional terminal definitions, when you 
can use terml, term2 or term3; refer to Downloading Terminal Definitions on page 96. 

Pages This is the number of video pages supported by the terminal attached to the line. If you 

don't specify the correct number of pages, you may experience problems with page 
displays when switching between sessions. The documentation supplied with your 
terminal should tell you how many pages it supports. 

Host Port By default, the Host (TCP) Port is set to 23 (telnet). In most cases you can use 23 for both 

telnet and rlogin. 

Dial If your user is remote and will be dialling in via modems/ISDN TAs, set the Dial field to 

'in'. 

idle timer (change if you have any terminal server type connection) enter a period in seconds for 

which the idle timer will run. Use this timer to close a connection because of user 
inactivity. When the idle timer expires the unit will end the connection. The default value 
is 300 seconds, meaning the idle timer will expire 300 seconds after the last activity. The 
maximum value is 4294967 seconds (equal to 49 days, approximately). A value of 0 (zero) 
means the idle timer will not expire so the connection is open permanently. 



Caution In addition to this line idle timer, you can configure an idle timer associated with a particular user. The user idle 

timer will override the line idle timer. See Section Configure a User Account. 
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session timer enter a period in seconds for which the session timer will run. Use this timer to forcibly 
close a user's session (connection). When the session timer expires the unit will end the 
connection. The default value is 0 (zero), meaning that the session timer will not expire 
(the session is open permanently, or until the user logs out). The maximum value is 
4294967 seconds (equal to 49 days, approximately). 



Caution In addition to this line session timer, you can configure a session timer associated with a particular user. The 

user session timer will override the line session timer. See Section Configure a User Account. 

3. Ignore the other fields in this form. 

4. Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

changes to a line will take effect the next time the user logs in. The exception is the 'terminal' parameter 
where the change will take effect immediately. 

5. If your user is remote and will be dialling into the unit via modems/ISDN Terminal Adaptors, do the 
following: 

a) , from the Line Configuration Menu, select 'Add Modem'. Enter the name of the 
modem/ISDN TA attached to the unit. You can enter a maximum of twenty names, each 
with nineteen alphanumeric characters. 

b) . from the Line Configuration Menu, select 'Change Modem'. Select your modem name. 
Enter the initialisation string; see your modem/ISDN TA documentation. 

6. Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

7. Go back to the 'Line Settings' menu. Select your line. When the line parameters form appears go the 
field 'modem name'. Press 'L' (upper or lower case) or the spacebar. Choose the modem name which 
you entered at Step 5. 

8. Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

You can copy the settings for this line to all other lines; refer to Copy settings to other lines 
on page 26. 

You can reset this line to default (an option as you exit this form); refer to Reset Serial 
Line to Default on page 27 

You may want to save your all your configuration changes permanently; see Section Save to non-volatile 
memory. 

You will now need to configure user accounts and to setup user sessions. Go to Chapter 4 (Configuring a 
User). 



Copy settings to other lines 

This feature enables you to change a parameter (e.g. line service) and then copy that change to some or all 
lines. It is available in the Line Settings form (under the Line Configuration Menu). 

• Select a line and make the required change (e.g. change line speed from 9600 baud to 57600 baud). 

• Press <return> to display the 'Options' form: 
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• Select 'copy settings to other lines'. Another form will be displayed which allows you to select other 
lines. 



Qopt ionsn 
and ex i t for 



reset t o def aul t 

copy settings to other lines 



Reset Serial Line to Default 

cli syntax: This feature enables you to reset the serial line which you are configuring to the default settings. It is 

reset line available in the Line Settings form (under the Line Configuration Menu). This line will be reset to 9600 

baud, 8 data bits, 1 stop bit, no parity and software flow control; the line type will become 'jslogin', the 
TCP Port '23', the idle timer '300' seconds and the hostname the first host entered in the host table. 

• Press <return> to display the 'Options' form: 



reset t o def aul t 

copy settings to other lines 



• Select 'reset to default'. 



Save to non-volatile memory 

When you exit a menu screen (form) after making changes, you will be presented with the options form: 



reset t o def aul t 

copy settings to other lines 



If you choose to 'accept and exit form' your changes will be retained in RAM (volatile memory). 

To save your changes permanently go to the Main Menu and select 'command line mode'; you will be 
presented with a form: 



=n1 



SHexiL full screen model 
exit and saue changes 



exit without sauing changes 
return to main menu 



Choose 'exit and save changes'. All the changes made since last entering the menus will be saved to 
FLASH (permanent, non-volatile) memory. The writing to FLASH will take a few seconds and during 
this time the unit will not respond to user input. 
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WARNING Do NOT turn off the power while the unit Is writing to FLASH memory. 

ell syntax: You should now be at the unit's command line prompt. To return the text menus type: screen 

screen 

Saving to a file 

netsave You can also save your configuration information to a file on a host. This can only be done in 

the cli; see Section netsave. 

Reverse Telnet connection 

ell syntax: A reverse telnet connection enables a TCP/IP host on the local network to establish a login connection via 

set line a JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') port on a non-TCP/IP machine external to 

the network; (see Figure 5). The unit will effectively be transparent. 

Figure 5A Typical Reverse Telnet Configuration 



user sees a 
login on the 
non TCP/IP 
host 



TCP/IP 
host 



local network 



JETSTREAM 

(any model), 
or LANSTREAM 



reverse telnet 




async port 



external 
non TCP/IP 
host 
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To set up a reverse telnet connection, follow these steps: 

1 . Select Line Settings from the Line Configuration menu then select the line that you want to configure. 

2. Set the 'Service' field to rev tel. 

3. Assign a TCP port number to the unit port using the 'JS Port' field. This TCP port number will be 
used by any host wanting to access the unit port. If you select a TCP port being used by another 
process, a connection will not be established (using a number in the range 900-1023 should be safe). 

4. To set up a hunt group, assign the same TCP port number to more than one reverse telnet port. The 
unit will use the first free port it finds in the group. 

5. Do not configure the idle and session timers; these timers have no effect on reverse telnet 
connections. 

6. The 'Hostname' and 'Host Port' fields may contain default or last-used values, but these will be 
ignored. 

7. The 'Secuity' field may be configured to 'on' or 'off (default). The security field option authenticates 
the user before allowing access to the line when enabled. 

8. The line should now be configured similar to the following: 





-+EBS9g|+ 1 


speed[%00 ] 


terminal [dumb ] 


f louuCnone ] 


pages [4] 


bitsCS] 


usert ] 


par i ty [none ] 


hostname[sco ] 


stopCl] 


host port[23 ] 


secur i t y C off ] 


JS port[900 ] 


dialCnone ] 


modem name none 


phone numberC 


] 


idle timer C 


] session t inert ] 



9. Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

10. You can copy the settings for this line to all other lines; refer to Copy settings to other lines on page 
26. 

11. If you want to configure all lines with the same parameters, refer to Reset Serial Line to Default on 
page 27. 

12. On the non-TCP/IP machine, configure the line for the required purpose (e.g. login). 

13. To access the external machine from a TCP/IP host, use the following command: 
telnet name j s_port 

Where: 

name is the hostname of the JETSTREAM 4000, 8500 or LANSTREAM 2000 unit. 

js _port is the TCP port number assigned to the JETSTREAM 4000, 8500 or LANSTREAM 
2000 port. 
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Chapter 2 Host Control of Ports and 
Printing 

Introduction 

This chapter tells you about advanced uses of the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 
'unit') with printers and modems. A TCP/IP host is required to run a program or utility to control the unit's 
ports, so that the ports appear local to the host. The program or utility could be LDP, RCP, a custom 
program or our own utility called MTSD. We discuss MTSD in detail. 

This chapter is divided into the following sections: 

• Introduction 

• Remote Printing using LPD 

• Remote Printing Using RCP 

• Remote Printing Using Host-Based Print Handling Software 
' External host: Dialin Modem Connections 

• Local host: Dialout Modem Connections 

' Host to host: bidirectional Modem Connections 

• Modem and Printer Handling Using MTSD 
' Copy settings to other lines 

' Reset Serial Line to Default 

• Save to non-volatile memory 

Note For an overview of all line types (including those discussed in other chapters in this guide) see Appendix A 

(Summary of Line Service Types). 
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Figure 6 Using the unit to share a modem/ISDN TA pool 
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Figure 7 Using the unit to share a printer pool 
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Remote Printing using LPD 

Printers connected to JETSTREAM 4000, 8500 or LANSTREAM 2000 (the unit') serial and parallel 
ports can be accessed by other TCP/IP hosts on the network using the LPD protocol; see Figure 7. 

This section consists of: 

LPD Configuration step-by-step 

LPD Configuration Example 



LPD Configuration step-by-step 

In your unit you can use the following line service types: 
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printer 

For serial port configuration see below; for parallel port configuration see the section parallel port on the 
next page. 

serial port 1. Select 'Line Port Settings' from the Line Configuration menu. Select the serial line to which your 

printer is attached; (in the cli use the command set line). Set the service field to one of the 
line service types listed above. Look at the example line below (serial line default values shown): 



service f BHWEBB ] 

speed [ S 6 00 ] 
f low [none ] 
bits[S ] 
pari ty [none ] 
stop [ 1 ] 
security [of f ] 

dial [none ] 
phone number [ 



terminal [ dumb ] 
pages [ 4 ] 
user [ 
hostname [ sco 
host port [23 ] 
JS port [23 ] 

modem name none 



idle timer[ 



] session t imer [ 



2. Configure the speed, flow, bits, parity and stop parameters. 

It is not necessary to set the hostname terminal, pages, user , dial , modem, name and 
phone number fields; these are ignored by the unit for this line service (printer). The JS port, 
idle and session timer fields may contain default or last-used values, but these also will be 
ignored by the unit. 

Tip To reset the line to default, press <En ter> from any point in the form and accept the 'reset to default ' option; 

see Reset Serial Line to Default on page 53. 

3. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53). 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

4. Go now to the section configuration continued. 



parallel port 
JS4000 



1 . Select 'Parallel Port Settings' from the Line Configuration menu. Select the parallel line to which 
your printer is attached; (in the cli use the command 

set parallel). Ensure the service field is set to printer . Look at the example line 
below (printer line service type default values shown): 





parallel 1 






service 


[printer] 






hostname 


[none ] 


host port 


[23 ] 






JS port 


[23 ] 
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2. Configure the hostname parameter; it will default to the first host you have entered in the unit's 
host table. 

You do not need to set the host port and JS port fields. 

Tip To reset the line to default, press <Enter> from any point in the form and accept the 'reset to default ' option; 

see Reset Parallel Line to Default on page 54. 

3. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



configuration 4. Kill the line: from the Main Menu go to the Line Configuration menu and select 'kill line' (in the cli 
continued use the command kill line). 

5. You now need to configure LPD on the network host. 

If your network host is running SCO Open Server v5 follow the LPD Configuration Example in Remote 
Printing using LPD on page 33. 

If you network host is running other operating systems, for example Windows NT, you will need to 
know: 

the name/ip address of the Perle device 
the printer queue name 

For further information see paragraph 2. in LPD Configuration Example on page 35 below. 

6. To execute the lpd print job see Executing an Ipd job on page 37. 



LPD Configuration Example 

In this example the network host is running SCO Open Server v5. 

1. On the network host, with root permission, type scoadmin and then make the following selections: 

1 . 1 From the Printer Menu, select Add Printer. 

1 .2 Select Add TCP/IP printer. 

1 .3 You should be presented with the following dialog box: 
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free 

format 

name 



Perle 

device 

name 

Queue 
name 



HP 


LaserJet 


5P/5MP 


(PCL) 


HP 


LaserJet 


5P/5MP 


(Postscript) 


HP 


LaserJet 


5Si/5Si 


MX (PCL) 



Add Printer Connected via TCP/IP 

Name [jetstreaml] Protocol Type [ lpd(BSD) 

Make/model 



Printer Connection Type 



Remote System: 
| stimpy 

Remote printer: 
I raw 2 



OK 



[Cancel] 



< > On 
Network 



[select] 



<*> On 
Remote- 
Server 



select option 
on remote server' 
[that is, on the Perle 
device) 



[Help] 



1.4 Using the example above, complete the fields in the form. For details on selections/input in the 
Remote System and Remote printer fields see the information in the paragraph below. 

2. Check the following configuration information: 



information field name in 

you will need SCO Open Server 5 



your action 



example syntax and 
comments 



name or ip 
address of Perle 
device 



Remote enter/select the name or ip address of 
system the Perle device. If you select the 

name, this is the JETSTREAM 4000, 
8500 or LANSTREAM 2000 name 
recognised by the SCO system. 



stimpy or 
192.65.144.32 
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queue name Remote 
printer 



for a serial port enter/select a queue 
name in the format: 



raw_p<port_number> or 
ascii_p<port_number> 

and for a parallel port In the format: 

raw_<port_number> or 
ascii_<port_number> 



for example: 
raw_p4 or 
ascii_p4 



for example: 
raw_4 
ascii 4 



If you want direct output to a hunt 

group, raw_p or ascii_p (to 

omit the port number(s). For example: hunt the serial 

ports, or 
raw_ or ascii_ (to 
hunt the parallel 
ports) 

For more information on queue names see section queue types below. 



queue types (refer to information queue name above) The Perle device will recognize two queue types, raw and ascii: 

raw : the Perle device passes the complete print job - without filtering - through to the attached printer. 
Most print jobs will require the raw option. 

ascii : the Perle device filters ascii characters from the print job. Some printers could require the ascii 
option, for example dumb printers. 

You can append an optional _d or _f to the queue name which adds a <control d> or <form feed> to 
the end of the job. Some printers may require the above commands or characters. 

3. If you are running SCO Open Server, exit scoadmin and go to Executing an Ipd job on page 37. 



Executing an Ipd job 

To execute an Ipd job from the command line (on a UNIX network host) use the following command: 
lp filename 

Notes 1 . On a serial port match the line speed in the unit to the serial printer port speed. 

2. If the port is not set up as a printer port, the job will fail. 

3. If you want to set up a hunt group, make sure the same type of printer is connected to each of the 
unit's ports. The unit will output the file to the first free serial or parallel printer port. The syntax you 
have used will determine whether the unit hunts the serial or the parallel ports. 
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Remote Printing Using RCP 

Printers connected to the serial and parallel ports of the units can be accessed by other TCP/IP hosts in the 
network using the RCP protocol; see Figure 7. These connections are set up using the printer line service 
type. 

This section consists of: 

• RCP Configuration step-by-step 

• RCP Configuration Example 

For serial port configuration see the section serial port below; for parallel port configuration see the section 
parallel port on the next page. 



RCP Configuration step-by-step 

serial port 1. Select 'Line Port Settings' from the Line Configuration menu. Select the serial line to which your 

printer is attached; (in the cli use the command set 1 ine). Ensure the service field is set to 
printer. Look at the example line below (serial line default values shown): 



service [ 



speed[9600 
f low [none ] 
bits[B] 
pari ty [none ] 
stop [ 1 ] 
security [of f ] 



terminal [ dumb 
pages [ 4 ] 
user [ 
hostname [ sco 
host port [ 2 3 
JS port [23 



dial [none ] 
phone number [ 



modem name none 



idle timer[ 



] session t imer [ 



2. Configure the speed, flow, bits, parity and stop parameters. 

It is not necessary to set the hostname, terminal, pages, user, dial, modem, name 
and phone number fields; these are ignored by the unit for this line service (printer). The JS 
port, idle and session timer fields may contain default or last-used values, but these also 
will be ignored by the unit. 

Tip To reset the line to default, press <Enter> from any point in the form and accept the 'reset to default ' option; 

see Reset Serial Line to Default on page 53. 

3. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

4. Go now to the section configuration continued. 
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1 . Select 'Parallel Port Settings' from the Line Configuration menu. Select the parallel line to which 
your printer is attached; (in the cli use the command 

set parallel). Ensure the service field is set to printer . Look at the example line 
below (printer line service type default values shown): 





parallel 1 






service 


[printer] 






hostname 


[none ] 


host port 


[23 ] 






JS port 


[23 ] 



2. Configure the hostname parameter; it will default to the first host you have entered in the unit's 
host table. 

You do not need to set the host port and JS port fields. 

Tip To reset the line to default, press <Enter> from any point in the form and accept the 'reset to default ' option; 

see Reset Parallel Line to Default on page 54. 

3. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



configuration 
continued 



executing an 
rep job 



4. Kill the line: from the Main Menu go to the Line Configuration menu and select 'kill line' (in the cli 
use the command kill line). 

5 . You now need to direct output from the network host to the printer. 

The usual method is to issue the rep command from the command line; see the section executing an rep 
job below. 

If you intend to send many print jobs you can either: 

use a hunt group, (see the section executing an rep job below), or 

modify the printer interface script(s) on the network host so it will continue trying to send the print job 
when the unit's printer port is busy; see the section modifying printer interface script further below. 

(If you do not wish to modify printer interface scripts, you may wish to print using lpd. The unit 
supports lpd; see Section Remote Printing using LPD). 

To execute an rep job from the command line, use the following commands: 

syntax 



port type on unit 

a serial port 



rep filename 
productname : pn 



example 

rep myfile 
stimpy:p4 
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a hunt group on serial ports rep filename rep myfile stimpy:p 

productname : p 

a parallel port rep filename rep myfile stimpy:1 

productname : n 

a hunt group on parallel ports rep filename rep myfile stimpy: 

productname : 



Where: 

productname is the name (servername) you have assigned to either the JETSTREAM or 
LANSTREAM unit. 

p indicates 'serial port' and is fixed. 

n is the serial or parallel port (number) to which the printer is connected. 



Caution JETSTREAM 8500 only: in previous versions of software the hunt group on a serial port did not require you to 

specify the letter ' p '. From now on you are required to specify the letter ' p ' as shown above. This change is 
necessary to introduce hunt group working on the new parallel port (where fitted). 



notes 1 . On a serial port match the line speed in the unit to the serial printer port speed. 

2. Multiple 'printer' connections will act as a hunt group, providing the same type of printer is 
connected to each port. The syntax you have used will determine whether the unit hunts the serial or 
the parallel ports. 

3. If the unit's port is not set up as a printer port, the job will fail. 

4. If the unit's port is busy, the job will fail (rejection message); this is a weakness of RCR To prevent 
job failure you can modify the printer interface script(s) as shown below. 

modifying printer On typical systemV based UNIX systems, the print spooler provides a set of back-end shell scripts for 
interface script talking to printers. These scripts are usually found in the /usr/spool/lp directory tree. An example of how 

you might modify one of these scripts is given below. 
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whi 1 e [ 


"$copies 


" -gt 0 ] 


do 








for file 






do 








while true 






do 






rep $file productname : pn 






if [ $? = 0 ] 






then 






break 






f i 






done 




done 






cop i e s = ' 


expr {copies -1' 


done 







RCP Configuration Example 

This example describes in SCO UNIX how to setup to use RCP to print to a simple serial printer connected 
to a JETSTREAM 8500. 



Example set-up: 



Device 


Name 


Comment 


Confiauration 


Host Server 


unixl 


running SCO OpenServer 5.0.2 


192.65.146.124 


JS8500 


jstest 


serial port 1 setup for rep printing 


192.65.146.122 


Printer Name 


jstestpl 


SCO printer name 




Printer Model 


jstestml 


Modified dumb printer model 




Test Printer 




Wyse 60 terminal 





JETSTREAM 8500 Set the required ports on the JETSTREAM 8500 to line service printer and the correct speed, etc. 
Configuration 



SCO 

Configuration 



Add an entry for the jstest device in /etc/hosts 

Test that rep printing is working correctly using the rep command from the command line; use syntax: 

rep /etc/hosts jstest:pl 

In /usr/spool/lp/model find the printer model you need and copy it. For this example the printer model dumb 
was used and copied to jstestml. Modify the new printer model to include the rep command. 
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the original line was: 

0<${file} eval ${FILTER} 2 >&1 
the new line is: 

rep $file jstest:pl 2>&1 

Create a new printer using scoadmin with a printer model of jstestml and a device of /dev/null. 

Once the printer has been started ( enable and accept ) the lp command can be used to print to the 
JETSTREAM 8500. 



Remote Printing Using Host-Based 
Print Handling Software 



Cli syntax: Printers connected to JETSTREAM 4000, 8500 or LANSTREAM 2000 ports can be accessed by TCP/IP 

set line hosts using print handling software. This type of connection uses the reverse raw line service. The print 

handling software needs to know the name of the unit and the TCP Port number assigned to the printer 
port. The same TCP Port can be assigned to a number of ports to form a hunt group. 

To setup a reverse raw printing connection, follow these steps: 

1 . Select 'Line Settings' from the Line Configuration menu and select the line that you want to configure. 

2. Set the Service field to 'rev raw'. 



service [rev raw] 



f low [none ] 
bits[8 ] 
pari ty [none ] 
stop [ 1 ] 
security [of f ] 

dial [none ] 
phone number [ 



idle tiiner[ 



t enn i na 1 [ £^M^H ] 

pages [ 4 ] 
user [ 
hostname[sco 
host port [23 ] 
JS port[lCl[l ] 

modem name none 



] session t imer [ 



Configure the speed, flow, bits, parity and stop parameters for the line. 

Enter a TCP port number in the JS port field. If you select a TCP port being used by another process, 
a connection will not be made (using a port number from 1024 upwards should work). 

To set up a hunt group, assign the same TCP port number to each printer line. The unit will use the 
first free line in the group. You can set up a maximum of eight hunt groups. 

Do not set the 'dial', 'modem name' and 'phone number' fields; these are ignored by the unit for this 
line service (reverse raw). The idle and session timer fields may contain default or last-used values, but 
these also will be ignored by the unit. 

Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53). 
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7. On each TCP/IP host wanting to access the printer, set up a process to talk to the TCP port assigned to 
the unit's port. You can either write a program to do this, or you can use the MTSD print handling 
service described in the section Section Modem and Printer Handling Using MTSD. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

External host: Dialin Modem Connections 

cli syntax: A dialin connection involves an external host connected to a JETSTREAM 4000, 8500 or LANSTREAM 

set line 2000 port trying to establish a connection with a TCP/IP host. In effect, the unit is trying to establish the 

connection. This type of connection uses the silent raw line service. The unit needs to know the name of 
the target TCP/IP host and the TCP Port number assigned, on the host, to listen for the dialin connection. 

Note The unit performs no modem configuration or initialisation with the 'silent raw ' line service. You must 
configure the modem BEFORE connecting it to the unit. Modems must be set to AUTO-ANSWER mode. 

To set up a dialin connection, follow these steps: 

1 . On the target TCP/IP host, assign a TCP port to listen for the dialin process. 

2. On the unit, select 'Line Settings' from the Line Configuration menu and select the line that you want 
to configure. 

3. Set the line service to 'sil raw'. 

4. Configure the speed, flow, bits, parity and stop parameters for the line. 

5 . Enter the name of the target TCP/IP host in the hostname field. 

6. Enter the allocated TCP port number in the host port field. 



1 40 

service [sil raw ] 


EBf+ 1 


speed [9600 ] 


terminal [ dumb ] 


f low [none ] 


pages [ 4 ] 


bits [8 ] 


user [ ] 


pari ty [none ] 


hostnamefsco ] 


stop [ 1 ] 


host port [1000 ] 


security [of £ ] 


JS port[^E ^1] 


dial [ in ] 


modem name none 


phone number [ 


i 


idle timer [ ] 


sess i on t i mer [ ] 



Set the 'dial' field to 'in'. Do not set the 'modem name' and 'phone number' fields; these are ignored 
by the unit for this line service (silent raw). The JS port, idle and session timer fields may contain 
default or last-used values, but these also will be ignored by the unit. 

Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53). 

On the TCP/IP host, set up a process to receive data on the Host TCP port. You can either write a 
program to do this, or you can use the MTSD modem handling service described in the section 
"Section Modem and Printer Handling Using MTSD'". 

may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



7. 

8. 
9. 

Tip You 
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Local host: Dialout Modem Connections 



cli syntax: Modems connected to JETSTREAM 4000, 8500 or LANSTREAM 2000 ports can be accessed for dialout 

set line purposes by TCP/IP hosts using modem handling software. This type of connection uses the reverse raw 

line service. The modem handling software needs to know the name of the unit and the TCP Port number 
assigned to the modem port. The same TCP Port can be assigned to a number of ports to form a hunt group. 

Note The unit performs no modem configuration or initialisation with the reverse raw line service. You must 
configure the modem BEFORE connecting it to the unit. Modems must be set to AUTO-ANSWER mode. 

To set up a dialout connection, follow these steps: 

1 . Select 'Line Settings' from the Line Configuration menu and select the line that you want to configure. 

2. Set the Line Service field to 'rev raw'. 



service[rev raw] 



speed[9600 
f low [none] 
bits[8 ] 
parityfnone] 
stop[ 1 ] 
security[of £ ] 

phone number [ 
idle tiiner[ 



terminal [dumb 
pages [ 4 ] 
user [ 
hostname [ sco 
host port [23 
JS port [1000 

modem name none 
] sess ion t i mer [ 



3. Configure the speed, flow, bits, parity and stop parameters for the line. 

4. Enter a TCP port number to the JS port field. If you select a TCP port being used by another process, 
a connection will not be established (using a number in the range 1024 upwards should work). 

5 . To set up a hunt group, assign the same TCP port number to each dialout line. The unit will use the 
first free line in the group. 

6. Set the dial field to 'out'. Do not set the 'modem name' and 'phone number' fields; these are ignored 
by the unit for this line service (reverse raw). The hostname, host port, idle timer and session timer 
fields may contain default or previous values, but these also will be ignored by the unit. 

7. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53). 

8. On each TCP/IP host that wants to access the modem(s), set up a process to talk to the unit's TCP 
port. You can either write a program to do this, or you can use the MTSD modem handling service 
described in the section "Section Modem and Printer Handling Using MTSD". 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



Host to host: bidirectional Modem Connections 

Cli syntax: You can set up bidirectional modem connections on a JETSTREAM 4000, 8500 or LANSTREAM 2000 

set line port using the bidir line service. This enables a modem connected to a unit's port to be used for dialin and 

dialout purposes. To set up a bidirectional modem connection, follow these steps: 
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1 . On the network host targeted by the dialin connection, assign a TCP port to listen for the connection. 

2. On the unit, select 'Line Settings' from the Line Configuration menu and select the line you want to 
configure. 

3. Set the Line Service to bidir. 





— 1 


1 


service [bidir 




speed [9600 ] 


terminal [dumb ] 


f low [none ] 


pages [ 4 ] 


bits[B ] 


user [ ] 1 


pari ty [none ] 


hostname [ sco ] 


stop [ 1 ] 


host port [2000 ] 


security [of f ] 


JS port [900 ] 


dial [both ] 


modem name none 


phone number [ 


] 


idle timer[ 


] session t imer [H H ] 



4. Configure the speed, flow, bits, parity and stop parameters for the line. 

5. To enable the dialout process, a TCP port number must be entered in the 'JS port' field. If you select a 
TCP port being used by another process, a connection will not be established (using a port from 
number 1024 upwards should work). 

6. To set up a hunt group, specify the same TCP port number in the 'JS port' field of each line whose 
'service' is set to 'bidir'. The unit will use the first free line in the group. You can create up to eight 
hunt groups. 

7. For the dialin process, specify the TCP port assigned on the target host in the 'host port' field. 

8. Enter the name of the target host in the 'hostname' field. 

9. Set dial to 'both'. Do not set the 'modem name' and 'phone number' fields; these are ignored by the 
unit for this line service (bidir). The idle and session timer fields may contain default or last-used 
values, but these also will be ignored by the unit. 

1 0. Accept and exit the form. If you wish, copy the line settings to other lines (an additional option as you 
exit the form; see Copy settings to other lines on page 53). 

1 1 . On the TCP/IP host targeted by the dialin connection, you must set up a process to receive data on the 
chosen TCP port. You can write your own program to do this or you can use the MTSD modem 
handling service described in the section Section Modem and Printer Handling Using MTSD. 

12. On each TCP/IP host which wants to use the dialout facility, set up a process to talk to the unit's TCP 
port. You can either write a program to do this, or you can use MTSD. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



Modem and Printer Handling Using MTSD 

MTSD is a host-based modem/print handling utility which enables applications, which need tty interfaces, 
to use JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') ports. Such applications are kermit, 
uucp and Ip; they use the unit's serial ports (and parallel ports - if fitted) so that the ports appear to be on the 
host. MTSD can be used to provide the following services: 

• Dialin modem handler 
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• Dialout modem handler 

• Bidirectional modem link 

• Printer server 

These modes can be invoked from the command line or set up to start automatically at boot (by editing 
UNIX start-up files). Thereafter the user can read/write to the link file created by the process. 

MTSD can be installed on any TCP/IP host running UnixWare/SVR4 or SCO UNIX system. 



Installing MTSD 

You will find MTSD on the Supplemental disk/CD supplied with the unit. The diskette contains an 
executable file, makefile and source code for each of the SCO and SVR4 operating systems. The 
executables are called mtsd.sco and mtsd.svr4. To install/compile MTSD, follow these steps: 

1 . Tar the contents of the diskette/CD onto the TCP/IP host, and 

either 

a. Copy the appropriate executable file to the hard disk (into /usr/bin, for example). MTSD is now installed. 

or 

b. Use the source code and makefiles to compile MTSD on other operating systems. 

or 

c. If you wish to compile the SCO and SVR4 makefiles, use the following make commands: 

make sco 
make svr4 

Note Any changes to the source code are not supported by Perle. 



Operation of MTSD 

The modes of operation and the commands used to invoke them are described below. All MTSD commands 
can be abbreviated to the shortest unambiguous form. A comprehensive menu-driven help utility can be 
accessed by typing mtsd -help in the directory in which MTSD is resident. The help utility provides 
information on each mode of operation and each command option. MTSD outputs a software version 
number when run. 



Start a Dialin Modem Handling Process 

On dialin connections, MTSD will now, by default, start a login process on a pseudo tty directly (rather than 
set up a getty to spawn a login process on the linkfile). 

Instead of reopening the same pseudo tty, MTSD selects the next available device in the list pO 1 ->pff->qO 1 - 
>qff->r01->rff->p01. 
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To set up a process to receive data on the TCP port assigned to the dialin connection, use the following 
command: 



mtsd -dialin - hos tpor t < t cppor tno > 

Where: 

<tcpportno> is the TCP port to accept connection on the host. 

The section "Section External host: Dialin Modem Connections" describes how to set up a dialin 
connection on a port. 
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Invoking a non-login process 

On dialin connections, MTSD by default invokes /bin/login with 'sane' tty settings. There are a set of 
options which enable you to invoke a non-login process. 

These are as follows: 
-path <pathname> 

pathname of required process (e.g. /bin/cat), 
-prog <program_name> 

name of program (e.g. cat). 

-pargl...9 <argument> 

enable you to specify a maximum of 9 arguments. 

-termfile <filename> 

the name of the file containing the termio settings (in stty -g format) to be used by the pseudo tty instead 
of the default 'sane ' settings. After completion of the invoked process, the 'sane ' tty settings will be 
resumed. 

-nologin 

defines the process as a USER_PROCESS for the purpose of updating fetc/utmp and wtmp files 
correctly. 

An example is given below: 

mtsd -dialin -hostport <tcpportno> -path /bin/cat -prog cat - 
par gl < f i 1 ename >- no login 
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-ttyname option on dialin connections 

On dialin connections, the -ttyname option will enable you to allocate a specific name to the selected pseudo 
tty. This name will then be displayed, instead of the ptty device name, when commands such as ps, tty and 
who are issued. When the connection is established, the pseudo tty will be removed from the /dev directory 
and replaced by the specified ttyname. This will be recorded in the file /etc/mtsd/ttyname enabling MTSD 
to recover the pseudo tty should the system crash. 

Note You may have to create the /etc/mtsd/ directory. 



-nolinger option on dialin connections 

There is a mechanism which prevents a network connection being closed before all data has been received 
and acknowledged by the other end. It is called the SO_LINGER mechanism 

The -nolinger option enables you to disable the SO_LINGER mechanism. If you are experiencing problems 
with the SO_LINGER mechanism, try using the -drain option to extend the timeout before resorting to the 
-nolinger option. 

Dialin under Unix SVR4 

On dialin connections under SVR4, the line discipline module is added by default. The relevant option is - 
noldterm. 

Start a Dialout Modem Handling Process 

MTSD can be used to set up a dialout process to connect to the TCP port assigned to the JETSTREAM 4000, 
8500 or LANSTREAM 2000 port. To set up a dialout process, use the following command: 



mtsd - di al out / - pr int er -mtsname <hostname> 
-mtsport <tcpportno> -linkfile <filename> 



Where: 

tcpportno is the TCP port number assigned to the unit's port. If this TCP port is assigned to 
a hunt group, MTSD will use the first free port in the group. 

filename is the name you want to assign to the file linked to the pseudo tty being used for 
the process. 

hostname is the hostname or internet address of the unit. 

The section Section Local host: Dialout Modem Connections describes how to set up dialout connections 
on the unit's serial ports. 

For dialout connections, a -noclose option is provided which will hold the pseudo try open after the 
network connection has closed, thus avoiding any connection closing issues. The -inactivity option 
enables you to set a period in minutes after which the pseudo tty should be closed regardless. 
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Start a bidirectional Modem Handling Process 

MTSD can be used to set up a dialin process to receive data on the host TCP port number and read/write to 
a named link file, then start a dialout process to read from the link file and connect to the JETSTREAM 
4000, 8500 or LANSTREAM 2000 TCP port. 

Note that the linkfile will be unlinked during dialin operation to prevent a dialout process being started. The 
link will be restored as soon as the dialin process has completed. 

To start this process, enter the following command: 

mtsd -both -mtsport <tcpportnoA> -hostport <tcpportnoB> - 
link <filename> -mtsname <hostname> 
Where: 

tcpportnoA is the TCP port assigned to the unit's port. If the TCP port is used by a hunt 
group, MTSD will use the first free port it finds. 

tcpportnoB is the TCP port number assigned on the TCP/IP host for the dialin connection. 

filename is a name you want to assign to the link file. 

hostname is the hostname or internet address of the unit. 

The section Section Host to host: bidirectional Modem Connections describes how to set up a bidirectional 
connection. 

NOTE: When running uugetty using the MTSD bidirectional facility, you must set it up so that it 
doesn't send the 'login:' prompt until the connection has been established. If you are running SCO 
UNIX this is performed by MTSD. 
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Start a Print Handling Process 

MTSD can be used to start a print handling process to read/write from a named link file and connect to the 
TCP port assigned to the printer port. To start this process, enter the following command: 

mtsd -print -mtsname <hostname> -mtsport <tcpportno> 
[- newline] -linkfile <filename> 

Where: 

hostname is the hostname or internet address of the unit. 

tcpportno is the TCP port assigned to the unit's port that the printer is attached to. If this 
TCP port number is assigned to a hunt group, the first free port in the group will be used. 

newline is an optional argument which will perform newline to carriage return newline 
mapping. 

filename is a name you want to assign to the link file. You must configure your UNIX 
printer to use this file as the print device. 

The section "Section Remote Printing Using Host-Based Print Handling Software" describes how to set 
up a remote printing connection. 



List of MTSD command options 

Table 1 A full list of MTSD command options is: 



MTSD Command Option 


Function 


■both|bidirectional 


Select bidirectional operation 


-debug 


If you include this argument, brief debug information 
will be displayed. 


-dialin |in 


select dial-in operation 


-dialout|out 


select dial-out operation 


■drain n 


This option enables you to specify the number of 
seconds before a connection is closed down. The 
default is 5 seconds. If you find that files or print jobs 
are being truncated, increase this value. 


■hostport <tcpportno> 


TCP port to accept connection on host 


-inactivity 


inactivity before connection is closed 


-linkfile|file 


select linkfile name 


-mtsname|host <hostname> 


select JETSTREAM 4000, 8500 or LANSTREAM 
2000 to connect to 
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-mtsport <tcpportno> 


TCP port assigned to hunt group on the unit 


-newline|mapping 


Enable NL to CRNL mapping on output 


-nodose 


<eep network connection open 


-noldterm| 
nolinedisc 


Do not push on 'Idterm/linedisc' 


-nolinger 


Do not invoke SO LINGER 


-nologin 


nvoke a program other than a login 


-opens n 


This argument enables you to specify the number of 
limes (after a one-second interval) that MTSD 
attempts to open the master pseudo tty. By default, 
MTSD makes 10 attempts. You will need to increase 
this value if the following error message is displayed: 

YITSD: re-open of master ptty 
failed. 


-pargx <argument> 


arguments; x is in the range 1-9 


-path <program_path> 


arogram's path 


-print 


select print operation to the unit 


-prog <program_name> 


orogram to be invoked 


-reconnects n 


This option enables you to specify the number of 
times (after a two second interval) that MTSD will try 
to establish a connection with the unit. The default is 
50. You will need to increase this value if you see the 
following message: 

V1TSD: reconnection tries 
exhausted - aborting. 


-retry n 


This option enables you to specify the number of 
times (after a one-second interval) that MTSD 
attempts to read the master pseudo tty before 
deciding that no process is active. By default, MTSD 
makes 5 attempts. You will need to increase this 
value if you find that connections are being closed 
whilst still active. If you find that connections are 
seing reopened too quickly, set retry to 0. 


-termfile 


termio settings file to use 


-ttyname 


specify a fixed tty name 


-verbose 


Include this argument if you want to receive full 
debug information. 
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Copy settings to other lines 

This feature enables you to change a parameter (e.g. line service) and then copy that change to some or all 
lines. It is available in the Line Port Settings form and Parallel Port Settings form (under the Line 
Configuration Menu). 

• Select a line and make the required change (e.g. change a serial line speed from 9600 baud to 57600 
baud). 

• Press <return> to display the 'Options' form: 



flopt ionsfl 

and exit for 



reset t o def aul t 

copy settings to other lines 



• Select 'copy settings to other lines'. Another form will be displayed which allows you to select other 
lines. 



Reset Serial Line to Default 



cli syntax: This feature enables you to reset the serial line which you are configuring to the default settings. It is 

reset line available in the Line Port Settings form (under the Line Configuration Menu). This line will be reset to to 

9600 baud, 8 data bits, 1 stop bit, no parity and software flow control; the line type will become 'jslogin', 

the TCP Port '23' and the hostname the first host entered in the host table. 

• Press <return> to display the 'Options' form: 

I^^^^^^^B':' P i ri -" 

II accept and exit for 



reset to default 

copy settings to other lines 



Select 'reset to default'. 
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Reset Parallel Line to Default 



cli syntax: This feature enables you to reset the parallel line which you are configuring to the default settings. It is 

reset parallel available in the Parallel Port Settings form (under the Line Configuration Menu). This line will be reset to 

line type 'printer', the hostname the first host entered in the host table, the host port '23' and the JS port 

'23'. 

• Press <return> to display the 'Options' form: 



flopt ionsB 

and exit for 



reset t o def aul t 

copy settings to other lines 



• Select 'reset to default'. 



Save to non-volatile memory 

When you exit a menu screen (form) after making changes, you will be presented with the options form: 



Dopt ionsq 

and ex i t for 



reset t o def aul t 

copy settings to other lines 



If you choose to 'accept and exit form' your changes will be retained in RAM (volatile memory). 

To save your changes permanently go to the Main Menu and select 'command line mode'; you will be 
presented with a form: 



SSHexit full screen niuiJeB^^H 

exit and saue changes II 



exit without sauing changes 
return to main menu 



Choose 'exit and save changes'. All the changes made since last entering the menus will be saved to 
FLASH (permanent, non-volatile) memory. The writing to FLASH will take a few seconds and during 
this time the unit will not respond to user input. 



WARNING do NOT turn off the power while the unit Is writing to FLASH memory. 

You should now be at the command line prompt. To return the text menus type: 

ell syntax: screen 
screen 
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Saving to a file 

netsave You can also save your configuration information to a file on a host. This can only be done in 

the cli; see Section netsave. 
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Chapter 3 Configuring a Line: - 
SLIP and PPP Connections 

Introduction 

This chapter deals with setting up SLIP and PPP connections on a line. It describes how your SLIP or PPP 
service can be started by a RADIUS host. There is also a summary of the configurable features of modems. 

You will see that the JETSTREAM 4000, 8500 or LANSTREAM 2000 is called the 'unit'. The use of the 
word 'unit' avoids frequent repetition of the product names. 

Chapter contents 

This chapter is divided into the following sections: 

• Overview 

SLIP, PPP and RADIUS 
Use SLIP or PPP? 

• Setting Up the Line 

• Configuring SLIP 

• Configuring PPP 

• Modems: summary of configurable features 

• Copy settings to other lines 

• Reset Serial Line to Default 

• Save to non-volatile memory 

Note For an overview of all line types (including those discussed in other chapters in this manual) see Appendix 

A (Summary of Line Service Types). 

Overview 

We discuss two main uses of a SLIP or PPP connection: 

1. Remote user. .With SLIP or PPP on a port so that a remote user can connect and use the 
network as if that user is connected locally. See Figure 8. 
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Figure 8 A remote access connection 
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You will need to configure the port (Setting Up the Line on page 63), configure SLIP (Configuring SLIP on 
page 65) or PPP (Configuring PPP on page 67). 

An example of a remote access connection using PPP, including the setup of a remote user is described in 
Chapter 8. 

2. Joining together two networks. With SLIP or PPP you can use two units to connect together two 
networks. The units will be acting as routers. 
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Figure 9 Joining together two networks 
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In the above scenario calls can be made from the local to the remote network, but not the other way round. 

(To allow calls from the remote to the local network, you would change the 'dial' parameters from 'out' to 
'in' on the modem/ISDN TA attached to the first unit and from 'in' to 'out' on the modem/ISDN TA 
attached to the second unit). 

You will need to configure the line(Setting Up the Line on page 63) then configure SLIP (Configuring SLIP 
on page 65) or PPP (Configuring PPP on page 67). 

An example of joining together two networks is presented in Joining together two networks on page 143 



SLIP, PPP and RADIUS 

When a user is authenticated by RADIUS the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 
'unit') starts a user service of SLIP or PPP based on instructions passed down by the RADIUS host. SLIP 
or PPP parameters configured in the unit will not be used; see Figure 10. 
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Figure 10 SLIP or PPP service from a RADIUS host 




user situated 
either locally 
or remotely 



The Specialix unit starts a SLIP or PPP service 

using configuration parameters passed down by the RADIUS host. 

These parameters apply to the user and the line. 

Note: equivalent line parameters 

configured in the Specialix unit will not be used; 

the RADIUS parameters will take precedence 



How to configure authentication is explained in the JETSTREAM 4000, 8500, LANSTREAM 2000, 
Installation Guide, Section Initial Configuration. 

An example of RADIUS parameters is shown in Figure 1 1; the file shown here is maintained on the 
RADIUS host. 
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Figure Hexample RADIUS user file: PPP service 



angelaPassword = "rodeo" 
User-Service = Framed-User , 
Framed-Protocol = PPP, 
Framed-Address = 192.65.144.6, 
Framed-Netmask = 255.255.255.0, 
Framed-Routing = None, 

Framed-Compression = Van- Jacobson-TCP-IP, 

Framed-MTU = 150 0, 

Idle-Timeout = 0, 

Session-Timeout = 0, 

Callback -Number = "981587793258" 



An explanation of the file shown in Figure 1 1 is as follows: 



User-Service and Framed-Protocol is the entry which instruct the unit to start a PPP service for the 
user (this equates to a user service of PPP; see Configure a User Account on page 82. However, since 
this user has been authenticated by RADIUS all the user parameters are provided by RADIUS). 

Framed-Address, Framed-Netmask, Framed-Compression and Framed-MTU all have 
equivalent parameters in the unit's PPP line configuration (see Configuring PPP on page 67). The 
RADIUS parameters override the unit's equivalent parameters (see Table 2 for a cross-reference of 
SLIP/PPP line parameters). 

Caution: the exception to the above rule is a Framed-Address value of 255.255.255.254. When this 
value is specified in the RADIUS file, the unit will use the Remote ip address configured for a PPP line 
in the unit. 

Any RADIUS parameters specified in the RADIUS file but not supported by the unit, e.g. Framed- 
Routing, will be accepted by the unit but not processed. The start of the user service should not be 
affected by such parameters. 

Idle-Timeout and Session Timeout have equivalent parameters in the unit's general line 
configuration (see Setting Up the Line on page 63). The RADIUS parameters override the unit's 
equivalent parameters (see Table 2 for a cross-reference of SLIP/PPP line parameters). 

Callback Number is associated with a user (i.e. it is not a line parameter in the unit). Since this user 
has been authenticated by RADIUS, all the user parameters (including a callback number) are provided 
by RADIUS. 

If you have user 'angela' also listed in the unit's user table (i.e. a duplicate entry - we do not recommend 
this action), all the user parameters configured in unit (see Chapter 4) for 'angela' will be overriden by 
the parameters in the RADIUS file; (for the user to be authenticated by the RADIUS host, where you 
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have a duplicate entry, the password for 'angela' in the unit would have to be different to that entered 
in the RADIUS user's database or authentication in the unit would have to be set to RADIUS (i.e. 
RADIUS only)). 

Additional note: 

The unit has additional parameters which you can configure for a line (e.g. speed, flow, modem name), 
for SLIP (e.g. local ip address, suppress ICMP) and for PPP (ACCM, security). If there are no RADIUS 
parameters specified in the RADIUS file for these unit's parameters, then the unit will use its' own 
configured values. 

To summarize, JETSTREAM 4000, 8500 or LANSTREAM 2000 begins a SLIP or PPP service for a 
user (when authentication has been carried out by the RADIUS host) with a mixture of values - some 
passed down by the RADIUS host and others taken from the unit's own configuration. 

Table 2 RADIUS: line, SLIP and PPP parameters supported by JETSTREAM 4000, 8500 or LANSTREAM 2000 



RADIUS parameters 
(supported by the unit) 


equivalent unit parameter 


where to find the unit's 
parameter 


Framed-Address 


Remote IP address 


Section 
Section 


Configuring SLIP, 
Configuring PPP 


Framed-Netmask 


Subnet Mask 


Section 
Section 


Configuring SLIP, 
Configuring PPP 


Framed-MTU 


Max TX Unit 


Section 


Configuring SLIP 




Max receive unit 


Section 


Configuring PPP 


Framed-Compression 


VJ_comp 


Section 
Section 


Configuring SLIP, 
Configuring PPP 


Idle Timeout 


Idle Timer 


Section 


Setting Up the Line 


Session Timeout 


Session Timer 


Section 


Setting Up the Line 



Use SLIP or PPP? 

If you require any of the features listed below, use PPP, otherwise SLIP should be sufficient. 

IP Address Negotiation. SLIP provides no mechanism for informing the other end of a link of its IP address, 
whereas PPP will do so. 

Error Checking. SLIP does not error check whereas PPP does. This is not necessarily a problem in SLIP 
since most upper layer protocols have their own error checking. 

Some systems exchange UDP packets with checksum disabled, which would cause problems should that 
part of an IP packet get corrupted. 

Authentication. Once SLIP has started you cannot authenticate the remote device, whereas as PPP provides 
the option of using security protocols PAP or CHAP. See Section Configuring PPP, then sub-section 
'Security' for further details. 
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Software Flow Control. You cannot use software flow control on SLIP links since there is no way of escaping 
control characters from the data stream. PPP has a facility (called ACCM) which allows specific control 
characters to be escaped from the data stream. See Section Configuring PPP for more details. 



For more information on the SLIP and PPP protocols see Appendix C (SLIP and PPP overview). 



Setting Up the Line 

Note You can also use RADIUS to initiate a SLIP or PPP connection; this is explained in SLIP, PPP and 

RADIUS on page 59. 

cli syntax: 1. Select 'Line Settings' from the Line Configuration menu, then select a particular line; e.g. line 2. The 

set line, following form will be displayed (default values): 

show line 



serui ceH Baffelff 

speed[9600 ] 
f 1 owCnone ] 
bitsCS] 
pari tyCnone] 
stopH] 
securi ty[off ] 

dialCnone ] 
phone numberC 

idle timerC 



terminal [dumb 
pages [4] 
user [ 
hostnametsco 
host port[23 
JS port[23 

modem name none 
] session t imer[ 



2. Go to the following fields: (use the spacebar to cycle through the line types (or type letter 'L' (upper 
or lower case) to list all possible values) 
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Service . We recommend you set: 

PPP - when you want a remote access service connection (see Figure 8) using PPP, or 
when you want to use the unit as a router (see Figure 9) with PPP. In both cases the user 
(whether real or dummy) will be authenticated within PPP (provided you use Security - 
PAP or CHAP). 

jslogin - when you want a remote access service connection (see Figure 8) using SLIP. Do 
not use the option 'SLIP' because there would be no authentication of the user; (instead, 
you will set SLIP for a particular user - see Section Configure a User Account). 

Choosing the 'jslogin' option, the unit will present the login prompt: the user will be 
required to enter a name and password and hence will be authenticated. 

If you are using scripts on the remote machine you may want the user to be prompted for 
a username and password; in this case you will want to set a line service of 'JS login'. 

SLIP - when you want to use the unit as a router (see Figure 9) with SLIP. There will be 
no authentication of each unit by the other unit. 

ty and Stop 

change as necessary from the default line configuration of 9600 baud, 8 data bits, no 
parity, 1 stop bit 

Flow Control field. The possible values are either 'soft' (software) or 'hard' (hardware). 
The default value is 'none'. 

For SLIP, set to 'hard' only. 

For PPP, set to either 'soft' or 'hard' ('hard' recommended). If you select 'soft' you must 
set the parameter ACCM when you configure PPP for the line (in Configuring PPP on 
page 67). 

do not enter a hostname; this field is used on terminal server connections only). 

this is the host TCP port number and is set by default to 23. In most cases you can use the 
default value. 

set to 'in' if your user is remote and will be dialling in via modem or ISDN TA; set to 'in' 
or 'out' if using the unit as a router, depending on which end of the link your unit is 
situated (see Figure 9). 

Phone Number when dial is set to 'out' and the line 'service' is set to 'slip' or 'ppp' enter a phone number 
for the unit to dial (you should only have this combination of settings when you are using 
two units back-to-back, i.e. as routers. 

Idle Timer (use only when using the unit as a router (see Figure 9)); enter a period in seconds for 
which the idle timer will run. Use this timer to close a connection because of inactivity. 
When the idle timer expires the unit will end the connection. The maximum value is 
4294967 seconds (equal to 49 days, approximately). A value of 0 (zero) means the idle 
timer will not expire, so the connection is open permanently. 



Speed, Bits, Pari 



Flow 



(Hostname 
Host port 

Dial 
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cli syntax: 
add modem 



set line 



Session Timer (use only when using the unit as a router (see Figure 9)); enter a period in seconds for 
which the session timer will run. Use this timer to forcibly close the session (connection). 
When the session timer expires the unit will end the connection. The default value is 0 
(zero), meaning that the session timer will not expire (the session is open permanently, or 
until you kill the line. The maximum value is 4294967 seconds (equal to 49 days, 
approximately). 

3. Ignore the other fields in this form. Press <return> to exit; if you do not wish to save your changes 
press the <escape> key. 

4. Go to the Line Configuration Menu: 

a) , select 'Add Modem'. Enter the name of the modem/ISDN TA attached to the unit. You 
can enter a maximum of twenty names, each with nineteen alphanumeric characters. 

b) . select 'Change Modem'. Select your modem/ISDN TA name. Enter the initialisation 
string; see your modem/ISDN TA documentation. 

5. Press <return> to exit; if you do not wish to save your changes press the <escape> key. 



Go back to the 'Line Settings' menu. Select your line. When the line parameters form appears go the 
field 'modem name'. Press 'L' (upper or lower case) or the spacebar. Choose the modem name which 
you entered at Step 4. 

Press <return> to exit; if you do not wish to save your changes press the <escape> key. 

You can copy the settings for this line to other lines (an option as you exit this line); refer 
to Copy settings to other lines on page 74. 

You can reset this line to default (an option as you exit this form); refer to Reset Serial 
Line to Default on page 74 

You may want to save your configuration permanently; if so, refer to Save to non-volatile memory on 
page 75. 



Configuring SLIP 



Note You can use RADIUS to run your SLIP connection; this is explained in SLIP, PPP and RADIUS on page 

59. 



cli syntax: Select 'SLIP' from the Line Configuration menu. Then select a line. The SLIP form will be displayed 

set slip line, (default values shown): 
show slip line 



local ip address [H 
subnet mask[ 

mtu[256 ] 
interact priori ty [on ] 
ts parameters [on ] 



] remote ip address [ 
] 

suppress icmp [off] 
vj_comp[on ] 



The details of the SLIP parameters are: 
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Local ip address. This is the IP address of the unit end of the SLIP link. For routing to work you must enter 
an IP address in this field. Choose an address which is part of the same network or 
subnetwork as the remote end; e.g. if the remote end is address 192.101.34.146, your local 
ip address may be 192.101.34.145; (in the cli, example syntax would be: 
set slip li 1 lipaddr 192.101.34.145) 

Do not use the unit's (main) ip address in this field; if you do so, routing will not take place 
correctly. 

Remote ip addressThis is the IP address of the remote end of the SLIP link. This must be specified. Choose 
an address which is part of the same network or subnetwork as the unit (see comment in 
'Local ip address' above). Enter the remote ip address in dot notation, e.g. 192.101.34.146 
(or in the cli, example syntax would be: set slip li 5 ripaddr 192.101.34.146) 

If your user is authenticated by the unit this remote ip address will be overriden if you have 
set a 'framed ip' address for the user with values other than 255.255.255.254 or 
255.255.255.255; see Section Configure a User Account, sub-section 'framed ip'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-Address' 
is set in the RADIUS file (see Figure 1 1 ) the unit will use the value in the RADIUS file in 
preference to the 'Remote ip address' value configured here. 

Subnet Mask this is the subnet mask of the node on the remote end of the SLIP link. This field is 
optional. This parameter should be entered in dot notation e.g. 255.255.255.224 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-Netmask' 
is set in the RADIUS file (see Figure 1 1 ) the unit will use the value in the RADIUS file in 
preference to the 'Subnet Mask' value configured here. 

Maximum transmission unit (mtu) 

The Maximum Transmission Unit (mtu) parameter restricts the size of individual SLIP 
packets being sent by the unit. Enter a value in bytes between 256 and 1006, e.g. 5 12 (in 
the cli, example syntax would be: set slip li 1 mtu 512). The default value is 256. For more 
information on this parameter see Section Configure a User Account, sub-section ' framed 
mtu'. 

If your user is authenticated by the unit this mtu value will be overriden when you have 
set a 'framed mtu' value for the user; see Section Configure a User Account, sub-section 
'framed mtu'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-MTU' is 
set in the RADIUS file (see Figure 1 1) the unit will use the value in the RADIUS file in 
preference to the 'mtu' value configured here. 

Suppress icmp This option causes ICMP (Internet Control Management Protocol) packets directed to this 
SLIP link to be discarded. The possible values are 'on' and 'off; the default is off. 

Interactive priority this determines whether interactive traffic (e.g. telnet sessions) is given priority over 
batch type traffic (e.g. ftp) thus avoiding the situation where a user has to wait for their 
character to be echoed while several large ftp packets are transferred. The possible values 
are 'on' and 'off; the default is on. 
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Tip 
Tip 



VJ Compression. This determines whether Van Jacobson compression is used on this link; i.e. whether you 
are using SLIP or C-SLIP (compressed SLIP). The choices are 'on' (C-SLIP) or 'off 
(SLIP); the default is 'on'. Select 'on' will turn on VJ compression. C-SLIP greatly 
improves the performance of interactive traffic, such as Telnet or Rlogin; see Appendix C 
(SLIP and PPP overview) for more information. 

In the cli, example syntax would be: set slip li 1 vj on. 

If your user is authenticated by the unit this VJ compression value will be overriden if you 
have set a 'framed compression' value for a user; see Section Configure a User Account, 
sub-section 'framed compression'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed- 
Compression' is set in the RADIUS file (see Figure 1 1) the unit will use the value in the 
RADIUS file in preference to the 'VJ compression' value configured here. 

TX parameters meaning Transmit parameters. This will output to the screen of the user all the SLIP 

parameters configured for that line/port. TX parameters are useful in some applications 
such as Trumpet Winsock. Options are 'on' or 'off. 

You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

If you want to configure several lines with the same parameters, go to Section Copy settings to other lines 
or Section Reset Serial Line to Default 



Configuring PPP 

Note You can use RADIUS to initiate your PPP connection; see SLIP, PPP and RADIUS on page 59. 

An example of a remote access connection using PPP, including the setup of a remote user is described in 
Chapter 8. 

cli syntax: Select 'PPP' from the Line Configuration menu. Then select a line. The PPP form will be displayed 

set PPP line, (default values displayed): 

show PPP line 



1 


+raBMHW=Ma+ 1 


local ip address [H 


tf] remote ip address [ ] 


subnet mask[ 


] accin [ ] 


mru[1500] 


secur i ty [ chap ] 


user [ 


] password [ ] 1 


ruser [ 


] rpassword[ ] 1 


address_comp [ on ] 


proto_coinp[on ] 


vj_comp[on ] 


magic_n.eg[of f ] 


ipaddr_neg[of f ] 




conf req . to[ 3 ] 


term. req. to[3 ] 


1 conf req. retries[10 ] 


term req. retries[2 ] 


conf nak retries[10 ] 


auth_tmout [ 1 ] 


roaming_callback[of f ] 


chal lenge_interval [ ] 



Complete the fields are as follows: 
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Local ip address. This is the IP address of the unit end of the PPP link. For routing to work you must enter 
a local IP address. Choose an address which is part of the same network or subnetwork as 
the remote end; e.g. if the remote end is address 192.101.34.146, your local ip address may 
be 192.101.34.145; (in the cli, example syntax would be: 
set ppp li61ipaddr 192.101.34.145) 

To see an example of ip address usage, refer to 'Figure 28 allocating local and remote IP 
addresses'. Do not use the unit's (main) ip address in this field; if you do so, routing will 
not take place correctly. 

Remote ip address. This is the IP address of the remote end of the PPP link. This must be specified. Choose 
an address which is part of the same network or subnetwork as the unit (see comment in 
'Local ip address' above). Enter the remote ip address in dot notation, e.g. 192. 10 1.34. 146; 
(or in the cli, example syntax would be: set ppp li 6 ripaddr 192.101.34.146). 

If you set the PPP parameter 'IP address negotiation' to 'on' the unit will ignore the remote 
ip address value you enter here and will allow the remote end to specify its ip address. 

If your user is authenticated by the unit this remote ip address will be overriden if you have 
set a 'framed ip' address for the user other than 255.255.255.254; see Section Configure 
a User Account, sub-section 'framed ip'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-Address' 
is set in the RADIUS file (see Figure 1 1 ) the unit will use the value in the RADIUS file in 
preference to the 'Remote ip address' value configured here. The exception to this rule is 
a Framed-Address value in the RADIUS file of 255.255.255.254; this value allows the 
unit to use the remote ip address value configured here. 

Subnet Mask this is the subnet mask of the node on the remote end of the PPP link. This field is optional. 
This parameter should be entered in dot notation e.g. 255.255.255.224 
(or in the cli, e.g., set ppp li 9 255.255.255.224). 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-Netmask' 
is set in the RADIUS file (see Figure 1 1 ) the unit will use the value in the RADIUS file in 
preference to the 'Subnet Mask' value configured here. 

ACCM. This allows the specification of an accm (asynchronous control character map) of 

characters that should be escaped from the data stream. This is entered as a 32 bit 
hexadecimal number with each bit specifying whether or not the corresponding character 
should be escaped. 

The bits are specified most significant bit first and are numbered 31-0. Thus if bit 1 7 is set, 
the 17th character should be escaped i.e. 0x1 1 (XON). So entering the value OOOaOOOO (in 
the cli, e.g. : set ppp li 1 accm OOOaOOOO) will cause the control characters Ox 1 1 (XON) and 
Ox 1 3 (XOFF) to be escaped on the link, thus allowing the use of XON/XOFF (software) 
flow control. 

If you have selected software flow control on the line (see Setting Up the Line on page 63) 
you must enter a value of OOOaOOOO for the ACCM. 

The default value is 00000000, which means no characters will be escaped. 
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Max. receive unitThe Maximum Receive Unit (mm) parameter specifies the maximum size of PPP packets 
that the unit's port will accept. Enter a value in bytes between 64 and 1500; e.g. 512 (in 
the cli, example syntax would be: set ppp li 1 mru 5 12). The default value is 1 500. For 
more information on this parameter see Section Configure a User Account, sub-section 
'framed mtu'. 

If your user is authenticated by the unit the 'mru' value will be overriden when you have 
set a 'framed mtu' value for the user; see Section Configure a User Account, sub-section 
'framed mtu'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed-MTU' is 
set in the RADIUS file (see Figure 1 1) the unit will use the value in the RADIUS file in 
preference to the 'mm' value configured here. 

Security. This specifies what type of authentication will be done on the link: none, PAP or CHAP. 

The default is CHAP. 

You can use PAP and/or CHAP to: 

a) authenticate a port or user on the unit, from a remote location, or 

b) authenticate a remote client/device, from the unit. 

PAP is a one time challenge of a client/device requiring that it respond with a valid 
username and password. A timer operates during which successful authentication must 
take place. If the timer expires before the remote end has been authenticated successfully 
the link will be terminated. 

CHAP challenges a client/device at regular intervals to validate itself with a username and 
a response, based on a hash of the 'secret' (password). A timer operates during which 
successful authentication must take place. If the timer expires before the remote end has 
been authenticated successfully the link will be terminated. 

With both PAP and CHAP make sure the unit and the remote client/device have the same 
setting, e.g. if the unit is set to PAP but the remote end is set to CHAP the connection shall 
be refused. For help - where your remote end is a Windows NT or 95 PC - see Setting up 
a Remote User (with PPP) on page 136, sub-section 'Windows NT4 or 95 configuration 
option'. 

In the cli, to turn on PAP (for example) the syntax would be: 
set ppp li 7 security pap 

If you have selected a line service of 'jslogin', PAP or CHAP will not take place since the 
user will have already been authenticated. In this case setting security to PAP or CHAP 
will have no effect. 

User . Complete this field only if you : 

- have specified PAP or CHAP (security protocols) in the 'Security' field, and 

- you wish to dedicate this line to a single remote user, and this user will be authenticated by the unit, or 

- you are using the unit as a router (back-to-back with another unit). 
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'User' is the name the remote device will use to authenticate a port on this unit (the 
opposite of the parameter 'Remote User'). The remote device will only authenticate your 
unit's port when PAP or CHAP are operating. You can enter a maximum of sixteen 
alphanumeric characters, e.g. kevinc8 (or, in the cli, example syntax would be set ppp li 
1 user kevinc8) 

When connecting together two networks, enter a dummy user name; e.g. JS_HQ. 

Note If you want a reasonable level of security the user name and password should not be similar to a user name 
or password used regularly to login to the unit. 

Password. Complete this field only if you : 

- have specified PAP or CHAP (security protocols) in the 'Security' field, and 

- you wish to dedicate this line to a single remote user, and this user will be authenticated by the unit, or 

- you are using the unit as a router (back-to-back with another unit). 

'Password' means the following: 

- in the 'Security' field, when you have specified PAP 'Password' is the password the 
remote device will use to authenticate the port on this unit (the opposite of the parameter 
'Remote Password'). The remote device will only authenticate your unit's port when PAP 
or CHAP are operating. 

- in the 'Security' field, when you have specified CHAP 'Password' is the secret 
(password) known to both ends of the link upon which responses to challenges shall be 
based. The remote device will only authenticate your unit's port when PAP or CHAP are 
operating. 

In both cases, you can enter a maximum of 16 alphanumeric characters; (in the cli, 
example syntax would be: set ppp li 7 password ******) 

Remote User. Complete this field only if you : 

- have specified PAP or CHAP (security protocols) in the 'Security' field, and 

- you wish to dedicate this line to a single remote user, and your user will be authenticated by the unit, or 

- you are using the unit as a router (back-to-back with another unit). 

'Remote User' is the name the unit will use to authenticate the port on the remote device 
(the opposite of the parameter 'User'). Your unit will only authenticate the port on the 
remote device when PAP or CHAP are operating. You can enter a maximum of sixteen 
alphanumeric characters; 

(in the cli, example syntax would be: set ppp li 6 ruser kevin) 

When connecting together two networks, enter a dummy user name; e.g. JS_SALES. 

Note If you want a reasonable level of security the user name and password should not be similar to a user name 
or password used regularly to login to the unit. 

Remote Password. Complete this field only if you : 

- have specified PAP or CHAP (security protocols) in the 'Security' field, and 

- you wish to dedicate this line to a single remote user, and this user will be authenticated by the unit, or 

- you are using the unit as a router (back-to-back with another unit). 

'Remote password' means the following: 
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- in the 'Security' field when you have specified PAP, 'Remote Password' is the password 
the unit will use to authenticate the remote device. 

- in the 'Security' field when you have specified CHAP, 'Remote Password' is the secret 
(password) known to both ends of the link upon which responses to challenges shall be 
based. 

In summary 'Remote Password' is the opposite of the parameter 'Password'. Your unit 
will only authenticate the remote device when PAP or CHAP are operating. 

In both cases, you can enter a maximum of sixteen alphanumeric characters; 
(or, in the cli, e.g., set ppp li 1 rpassword ******) 

Address/Control compThis determines whether compression of the PPP Address and Control fields shall 
take place on the link. The choices are 'on' or 'off; the default is 'on'. For most 
applications this should be enabled; i.e. 'on'. In the cli example syntax would be: 
set ppp li 1 address_comp on 

Protocol compressionThis determines whether compression of the PPP Protocol field shall take place on 
this link. The choices are 'on' or 'off; the default is 'on'. For most applications this should 
be enabled; i.e. 'on'. In the cli example syntax would be: 
set ppp li 1 proto_comp on. 

VJ Comp. This determines whether Van Jacobson Compression is used on this link. The choices are 'on' or 
'off; the default is 'on'. Select 'on' will turn on VJ compression. Select 'on' will turn on 
VJ compression. C-SLIP greatly improves the performance of interactive traffic, such as 
Telnet or Rlogin; see Appendix C (SLIP and PPP overview) for more information. In the 
cli, example syntax would be: set ppp li 1 vj on. 

If your user is authenticated by the unit this VJ compression value will be overriden if you 
have set a 'framed compression' value for a user; see Section Configure a User Account, 
sub-section 'framed compression'. 

If your user is authenticated by RADIUS and the RADIUS parameter 'Framed- 
Compression' is set in the RADIUS file (see Figure 1 1) the unit will use the value in the 
RADIUS file in preference to the 'VJ compression' value configured here. 

Magic No. negotiationThis is a mechanism whereby a line can determine if it has been looped back. The 
choices are 'on' or 'off; the default is 'off. If enabled (on) this option allows the sending 
of random numbers on the link. The random numbers should be different, unless the link 
has been looped back. In the cli, example syntax would be: set ppp li 1 magic_neg off. 

IP address negotiation. This parameter specifies whether or not IP address negotiation shall take place. IP 
address negotiation is where the unit allows the remote end to specify its ip address. The 
values are 'on' or 'off. The default value is 'off. 

If set to 'on' the unit allows the remote end to specify its ip address; the ip address 
specified by the remote end will then be used in preference to the Remote ip address set 
for a line. 

If set to 'off the unit will not allow the remote end to specify its ip address. The Remote 
ip address set for the line will be used. 

In the cli, example syntax would be: set ppp li 7 ipaddr_neg on. 
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When configuring your user (Configure a User Account on page 82), if you set 'framed 
ip' address to 255.255.255.255, the unit will override the value for IP address negotiation 
set here. The result is that the unit will allow the remote end to specify its ip address. 

Configure req. timeoutThis parameter specifies the maximum time in seconds that LCP (Link Control 
Protocol) will wait before it considers a 'configure request' packet to have been lost, 
(in the cli example syntax would be: set ppp li 8 cr_tmout 3). 

Terminate req. timeoutThis parameter specifies the maximum time in seconds that LCP (Link Control 
Protocol) will wait before it considers a 'terminate request' packet to have been lost; 
(in the cli example syntax would be: set ppp li 24 tr_tmout 3). 

Configure req. retriesThis parameter specifies the maximum number of times a 'configure request' packet 
will be sent before the link is terminated; 
(in the cli example syntax would be: set ppp li 23 cr_retry 10) 

Terminate req. retriesThis parameter specifies the maximum number of times a 'terminate request' packet 
will be sent before the link is terminated; 
(in the cli example syntax would be: set ppp li 13 tr_retry 2) 

Configure NAK retriesThis parameter specifies the maximum number of times a 'configure nak' packet 
will be sent before the link is terminated; 
(in the cli example syntax would be: set ppp li 2 nak_retry 10) 

Authentication timeout. The timeout in minutes during which successful PAP or CHAP authentication must 
take place; (you must have PAP or CHAP turned on). If the timer expires before the 
remote end has been authenticated successfully the link will be terminated, 
(in the cli example syntax would be: set ppp li 5 aufh_tmout 1) 

Roaming callbackallows the user to specify a telephone number which the unit should use to callback him/ 
her. This feature is particularly useful for a mobile user. The possible values are 'on' and 
'off; the default is 'off. The operation of roaming callback is shown diagrammatically in 
Figure 12. 

Roaming callback can only work with a user whose (fixed) callback parameter is set to 
'on'. See Section Configure a User Account. Roaming callback therefore overrides 
(fixed) callback. 

The user is allowed 30 seconds to input a telephone number after which the unit ends the 
call. 

Challenge_intervalsets the interval in minutes at which the unit will issue a CHAP re-challenge to the 

remote end. The default value is 0 (zero) meaning CHAP re-challenge is disabled. During 
CHAP authentication an initial CHAP challenge takes place, and is unrelated to CHAP re- 
challenges. The initial challenge takes place even if re-challenges are disabled. 

Some PPP client software does not work with CHAP re-challenges so you may wish to 
leave the parameter disabled in the the unit. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

Tip If you want to configure several lines with the same parameters, go to Section Copy settings to other lines 
or Section Reset Serial Line to Default 
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Figure 12 



Roaming callback 



To use roaming callback, the remote end must be a 
Windows NT4 or 95 PC (or more recent versions), or it must 
support Microsoft's Callback Control Protocol (CBCP) 



c a a 

o 3 a 



PPP line 



ROAMING 
CALLBACK 



OFF 



ON 

for the particular user you must set 
(fixed) callback to 'on'. See Section 
Configure a User Account. Unless 
fixed callback is set to on for user, 
he/she cannot receive roaming 

callback. 

i 

the user must initially dial into the 

unit on a line where roaming 
callback is set to 'on'. You must 
therefore provide the user with the 
telephone number for this type of 
line(s). 



the unit can still provide 
fixed callback - provided 
you have set the (fixed) 
callback parameter to 
'on' for that particular 
user; see Section 
Configure a User 
Account. 



after successful authentication the 
unit will prompt the user for a 
telephone number to call him/her 
back. After receipt of the number, 
the unit will drop the line, call the 
user back on that telephone 
number. The user will be 
authenticated again (a precaution). 
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Modems: summary of configurable features 

A summary of the configurable features for modems is listed below. 
Note all references to modems apply equally to ISDN Terminal Adaptors 

cli syntax: • you can set the 'dial' parameter to 'in', 'out' or 'none' (default 'none') in the line parameters sub- 

set line menu. Setting 'in' or 'out' tells the unit that there is a modem on that line. The unit will communicate 

with the modem through various RS232 signals. The 'dial' parameter can be set for all line services 

(e.g. jslogin, silent raw). 

set line • when dial is set to 'out' and the line service is set to 'slip' or 'ppp' you can enter a 'phone number for 

the unit to dial (line parameters sub-menu). This combination of circumstances occurs when you have 
two units connected back-to-back; i.e. they are acting as routers (see Figure 9). 

add modem • when the 'dial' parameter to 'in' and the line service is set to 'js_login', 'slip' or 'ppp' the unit can 
set modem initialise a modem. You enter a modem name and initialisation string in the modems sub-menu. The 

unit will initialise that modem before any new connection is started. 

• The unit will ignore any modem names or initialisation strings with the following line service types: 
direct (all types), silent (all types), printer, reverse, bidir 

You can however, set the 'dial' parameter. 

• when you are connecting from a terminal the unit offers automatic baud rate detection on the line. If 
you do not see any characters, or garbled characters, you send line breaks (<break> key) until the 
correct line speed setting is reached. The feature is explained in more detail in Section Logging in. 



Copy settings to other lines 

This feature enables you to change a parameter (e.g. line service) and then copy that change to some or all 
lines. It is available in the Line Settings form (under the Line Configuration Menu). 

• Select a line and make the required change (e.g. change line speed from 9600 baud to 57600 baud). 

• Keeping the cursor in the modified field, press <return> to display the 'Options' form: 



flopt ionsB 

and exit for 



reset t o def aul t 

copy settings to other lines 



• Select 'copy settings to other lines'. The change will be made to all lines. 



Reset Serial Line to Default 

cli syntax: This feature enables you to reset the serial line which you are configuring to the default settings. It is 

reset line available in the Line Settings form (under the Line Configuration Menu). The line will be reset to 9600 

baud, 8 data bits, 1 stop bit, no parity and software flow control; the line type will become 'JS login', the 
TCP Port '23', the Idle Timer '300' seconds and the hostname the first host entered in the host table. 
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Press <return> to display the 'Options' form: 



reset t o def aul t 

copy settings to other lines 



Select 'reset to default'. 



Save to non-volatile memory 



WARNING 



cli syntax: 
screen 



When you exit a menu screen (form) after making changes, you will be presented with the options form: 



Hoptionsfl 

accept and exit form 



reset t o def aul t 

copy settings to other lines 



If you choose to 'accept and exit form' your changes will retained in RAM (volatile memory). 

To save your changes permanently you will need to exit the menu system. Return to the Main Menu and 
select 'command line mode'; you will be presented with a form: 



*n1 



SSHsxit full screen model 
exit and saue changes 



exit without sauing changes 
return to main menu 



Choose 'exit and save changes'. All the changes made since last entering the menus will be saved to 
FLASH (permanent, non-volatile) memory. The writing to FLASH will take a few seconds and during 
this time the unit will not respond to user input. 

do NOT turn off the power while the unit Is writing to FLASH memory. 

You should now be at the command line prompt. To return the text menus type: 



Saving to a file 



netsave You can also save your configuration information to a file on a host. This can only be done in 

the cli; see Section netsave. 
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Chapter 4 Configuring a User 

Contents 

• Introduction 

• When you need User accounts 

• User accounts and RADIUS 

• Add a User Account 

• Configure a User Account 

• User Levels 

• Running Sessions 

• Change a User's Password 

• Delete a User Account 

• Language support 

• Save to non-volatile memory 



Introduction 

You need to configure user accounts on the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') 
for those users who want particular types of Terminal Server or Remote Access connections. If you are 
using a RADIUS host you may not need user accounts for those users who are authenticated by the 
RADIUS host; see User accounts and RADIUS on page 78. 

When you set up a User account you will see, as an example, the following form in the text menus: 



usernaiiie j ul ie 
screen switch[ 1 ] 

service[ jsproinpt ] 
tcp port [23 ] 
phone number [ 

idle timerf ] 



language r BBElFE3S 
level [normal 
ip_host [ 
callback[of f ] 

] 

sess ion t i mer [ 



f rained ip[ 2 5 5 . 255. 255. 254] framed netmask[ 



trained mtu[ 1500 ] 



framed compression [on ] 



More detail on this form is contained in Configure a User Account on page 82. 
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When you need User accounts 

The types of terminal server connections where you will need to configure user accounts are where users: 

• have a login directly on a local host, by-passing the unit (using the rlogin protocol) 

• are authenticated by unit and then have a telnet or rlogin service started on a host 

• want a single or multiple session(s) on a host; here they initially login to the unit before starting that 
session. The unit is used to configure and start the session. 

The remote access connections where you will need to configure user accounts are where users: 

• are being provided a remote access service, i.e. a SLIP or PPP connection, and they are being 
authenticated by unit. 

As the system administrator you will have your own user account (default name 'admin'). 

The unit's login accounts are password-protected and assigned a user level; this level restricts the user to 
certain commands; see Section User Levels. A maximum of 32 user accounts can be created. 

Note You may not need user accounts for users authenticated by the RADIUS host; see User accounts and 
RADIUS on page 78. 

User accounts and RADIUS 

You can have a maximum of 32 user accounts on the JETSTREAM 4000, 8500 or LANSTREAM 2000 
(the 'unit'). You will also be able to configure user accounts on the RADIUS host (the quantity will vary 
depending on the host). Therefore some users can be authenticated by the unit, other users by RADIUS. You 
could have other combinations of maintaining user accounts; i.e. duplicated on both the unit and the 
RADIUS host or, alternatively all user accounts stored on the RADIUS host only (except username 'admin' 
- this will always be stored in the unit and always authenicated by the unit). Whichever method you choose, 
make sure the setting for 'authentication' is correct - see JETSTREAM 4000, 8500, LANSTREAM 2000, 
Installation Guide, Section RADIUS configuration. 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



78 



perfe 



Figure 13 When RADIUS authenticates users (1 of 2) 



1.) 



JETSTREAM 
(any model), 
or LANSTREAM 




(when authentication is set to 'both') 
if the Specialix unit cannot 
authenticate user , it will 
send an authentication request 
to the RADIUS host 



authentication in 
the Specialix unit 
set to either 
'both' 

(first the Specialix unit 
then RADIUS) 
or 'RADIUS' 
(RADIUS only) 



(when authentication is set to 'RADIUS') 
the Specialix unit will not try to 
authenticate user. It will send 
an authentication request 
to the RADIUS host 




user dials in to 
the Specialix unit 
and inputs username 
and password 



user 
situated 
either locally 
or remotely 



..see next diagram 
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Figure 14 When RADIUS authenticates users (2 of 2) 



2.) 



r 



RADIUS host 
authenticates the user. 
In this example the 
username and password 
are correct 



the RADIUS host sends 
instructions for the service 
which the Specialix unit should 
provide to the user 



JETSTREAM 
(any model), 
or LANSTREAM 





situated 
either locally 
or remotely 



The Specialix unit starts a user service 

(e.g. telnet, SLIP) with configuration parameters 

passed down by the RADIUS host. 

These parameters apply to the user and to the line. 

Note: if your user is also listed in the user table 
of the Specialix unit, the parameters configured 
for him/her in the Specialix unit will not be used. 



Figure 13 and Figure 14 show that when a user is authenticated by RADIUS the unit starts a user service - 
such as telnet or SLIP - based on instructions passed down by the RADIUS host. User parameters - such as 
'service' or 'ip_host' are taken entirely from the RADIUS host. (This situation is totally different from users 
authenticated in the unit, where user parameters are taken from the unit's database). 

An example of parameters passed down by a RADIUS host to the unit is shown in Figure 15; this file is 
maintained on the RADIUS host. 
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Figure 15example RADIUS user file: telnet service 



davePassword = "garage" 
User-Service = Callback- login, 
Login-Host = 192.101.34.199, 
Login-Service = Telnet, 
Login-TCP-Port = 23, 
Class = "Indirect Sales Group" 
Session-Timeout = 1800, 
Idle-Timeout = 500, 
CallBack-Number = "3592" 



An explanation of the file shown in Figure 15 is as follows: 

- the file contains a mixture of user parameters (e.g. callback-number) and line parameters (e.g. login- 
host). 

- this user has been authenticated by RADIUS; therefore, all user parameters are passed down to the 
unit in this file. 

- if you also have user 'dave' listed in the unit's user table (i.e. a duplicate entry - we do not recommend 
this action) all the user parameters configured in the unit for user 'dave' will be overriden by the 
parameters in the RADIUS file; (for the user to be authenticated by the RADIUS host, where you have 
a duplicate entry, the password for 'dave' in the unit would have to be different to that entered in the 
RADIUS user's database or authentication in the unit would have to be set to RADIUS (i.e. RADIUS 
only)). 

-Class = "Indirect Sales Group" is a RADIUS class attribute. The unit can only process 
a string of maximum 32 characters; therefore limit your string to this size. In this example "Indirect 
Sales Group" is 20 characters (including spaces). 

- line parameters override those configured in the unit; see SLIP, PPP and RADIUS on page 59 for a 
more detailed discussion on line parameters. 



Add a User Account 

cli syntax: Select 'Add User' from the Users menu. 

add user „ ... ., . T . . . , TT 

Enter a username, maximum sixteen characters (do not use spaces). If your user is equipment (see User 

Service 'TCP clear:' in the next section) allocate an appropriate name, e.g. barcode2. 
Enter a password, maximum sixteen characters (do not use spaces). Re-enter the password. 
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Admin users can change user passwords using the 'Set Password' feature described in Change a User's 
Password on page 88. Normal users can change their own passwords; see Section Changing your 
Password. 



Configure a User Account 

Tip You are about to configure a user account in the unit. Your configuration will only be used if the user is 

authenticated by the unit. If the user is authenticated by RADIUS, the unit will use configuration details for 
users sent by the RADIUS host; see User accounts and RADIUS on page 78. 

cli syntax: 

set user l. Select 'Change User' from the Users menu. Choose your user from the list of names. As an 

example, the following form will be displayed (default values): 



usernane julie 
screen switch[ 1 ] 

service[ jsproinpt ] 
tcp port [23 ] 
phone number [ 

idle timerf ] 

framed ip[ 2 5 5 . 255 . 255 . 254 ] 
trained mtu[ 1500 ] £ 



language f BBEHB 
level [normal 
ip_host [ 
callback[o£ £ ] 

] 

sess ion t i mer [ 
] framed netmask[ 
framed compression [on ] 



2. Go to the following fields: 

Screen switch (ignore this field unless the user will be running sessions and has a user level of 'normal ' 
(see Section Running Sessions) 

this is the 'hot-key' command used, in conjunction with other keys, for switching between 
sessions. This may need to be changed if it clashes with an application a user is going to 
run in one of their sessions. It must be entered in hex format; the default is ' 1 ' ( A A). Refer 
to the ascii code chart in ASCII to Decimal and Hex Conversion Chart on page 243. 
Normal users can change their own screen switch character using the menus: Sessions>Set 
Up User>User environment. 

Service instructs the unit to start a user service by selecting one from the following list (once the 

user is authenticated successfully by the unit): 

js prompt: a login on the unit (the default setting). Use this service for you as the system 
administrator, or for users who wish to run a single or multiple sessions on Terminal 
Server connections; these sessions are configured within the unit (see Section Running 
Sessions). 

Telnet: a Telnet service provided by the unit. Use this service when you/a user is 
connected directly to a port via a serial line (i.e. not connected into one of the network 
ports). When the telnet service starts, the user will be authenticated by the host. Now go 
to the IP Host and TCP Port No fields. 

Tip When specifying the 'telnet ' option, we recommend you set the 'line service ' on that particular line to 

'jslogin '; see Section Starting Telnet/Rlogin from the unit. 
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Rlogin: an Rlogin service provided by the unit. Use this service when you/a user is 
connected directly to a port via a serial line (i.e. not connected into one of the network 
ports). When the rlogin service starts, the user will be authenticated by the host. Now go 
to the IP Host field. 

Tip When specifying the 'rlogin ' option, we recommend you set the 'line service ' on that particular line to 

'jslogin '; see Section Starting Telnet/Rlogin from the unit. 

TCP clear: use for devices which require a login, i.e. authentication. Such devices could be a bar code 

reader or smart card. 'TCP clear' provides a channel on which 8-bit data is passed, without 
interpretation, to a host. It has the same meaning as the TCP Clear login service specified 
in the RADIUS Authentication rfc; see Appendix D (References). 

SLIP: The SLIP service will be started using the SLIP parameters set for that line; see 
Section Configuring SLIP. There will be no further login prompt (unless callback is 
operating). The SLIP line settings will be taken from the settings configured for that line. 

Tip When specifying the 'SLIP ' option, we recommend you set the 'line service ' on that particular line to 

'jslogin '; see Section Setting Up the Line. 

PPP: The PPP service will be started using the PPP parameters set for that line; see 
Section Configuring PPP. There will be no further login prompt (unless callback is 
operating). The PPP line settings will be taken from the settings configured for that line. 

Tip When specifying the 'PPP ' option, we recommend you set the 'line service ' on that particular port to 

'jslogin '; see Section Setting Up the Line. 

Note Note also that some types of user service have the same name as line service types, e.g. 'user service: SLIP ' 
and 'line service. SLIP '. User 'service ' is explained in Section Configure a User Account. 

TCP Port No. (ignore this field unless you have selected a user Service of 'telnet') 

(telnet only) enter the TCP/IP port number of the host with which the unit should start the 
telnet service. The default port is 23; in most cases you should leave the value at default. 

phone number, enter a telephone number for the unit to call back the user; do not use spaces. You must 
also have 'callback' set to on. (The number you enter is unrelated to the 'phone_number' 
or 'dial' parameters you can set for a line). 

idle timer. (you may wish to change this setting for terminal server connections) enter a period in 

seconds for which the idle timer will run. Use this timer to close a connection because of 
user inactivity. When the idle timer expires the unit will end the connection. The default 
value is 300 seconds, meaning the idle timer will expire 300 seconds after the last activity. 
The maximum value is 4294967 seconds (equal to 49 days, approximately). A value of 0 
(zero) means the idle timer will not expire so the connection is open permanently. 

Note: this idle timer will override the idle timer which you can configure for a line. 

session timer. (you may wish to change this setting for terminal server connections) enter a period in 
seconds for which the session timer will run. Use this timer to forcibly close a user's 
session (connection). When the session timer expires the unit will end the connection. The 
default value is 0 (zero), meaning that the session timer will not expire (the session is open 
permanently, or until the user logs out). The maximum value is 4294967 seconds (equal 
to 49 days, approximately). 

Note: this session timer will override the session timer which you can configure for a line. 
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select either English or customlang (customised language);, how to set up a customlang is 
explained in Language of your choice on page 90. 

The language change will take effect when the user next logs in to the unit. On your own 
account, as system administrator (default name 'admin'), the language change will take 
effect as soon as you accept and exit this form. 

For more information on language availability and use, see Section Language support. 

Level this field cycles through 'admin', 'normal' and 'restricted'. These are privilege levels and 

are described in Section User Levels. The 'admin' user (i.e. you as system administrator) 
always has 'admin' level account (maximum privileges). 

IP Host . (ignore this field unless you have selected a user service of 'telnet ' or 'rlogin ' or 

'tcp clear'). 

0.0.0.0 - default. The unit will use the default ip host configured for all users who 
login to the unit. The default ip host is set in the 'server configuration' menu; 
see JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, Section 
Initial Configuration (or in the cli see command 'set server'). The IP address 
entered here does not affect the host table or any line configuration. 

255.255.255.255 - specified by user. The unit will prompt the user for an IP address or 
hostname, when the telnet or rlogin service is started. When the user service is set to 
Telnet, Rlogin or TCP Clear, the unit will give the user two attempts the enter the required 
information. 

n.n.n.n - (where 'n' is a number) you specify in this field the IP address of a host with 
which the unit should start the telnet or rlogin service for this user. 

callback. (callback for a user is also known as FIXED callback) the values are either 'on' or 'off 

(default is off). When 'on' enter a phone number for the unit to call the user back; see the 
field 'phone number'; (the callback setting is unrelated to the 'dial' parameter you can set 
for a line). 

Note: the unit will only allow callback when a user is authenticated. If the protocol over 
the link does not provide authentication there will be no callback. Hence, when the line 
service is set to 'PPP' you must use either PAP or CHAP (see Configuring PPP on page 
67, sub-section 'Security'), because these protocols provide authentication. 

For a diagrammatic view of callback, see Figure 16. Note that the unit supports another 
type of callback - ROAMING callback - which is configurable for a line when you are 
using the PPP protocol; see Configuring PPP on page 67. 
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Figure 16 



Callback for a user 



a .° a 
° 5 2 
O S B 



User 



> 



5 u 



CALLBACK 
(fixed) 



OFF 



The unit will not provide 
any type of callback to the 
user, neither fixed nor 
roaming. 

Note: Roaming callback is 
described in Section Configuring 
PPP 



ON 



the line must have authentication: 
for SLIP, set line service to JSJogin 

(set user service to slip) 
for PPP, set line service to PPP, and 
turn on either PAP or CHAP 
(set user service to PPP) 

enter a telephone number for the unit 
to dial the user 



The unit will call the user back, after 
successful authentication, using the 
telephone number entered for that 
particular user. 



except. 



when, for that PPP line, roaming 
callback is set to 'on'. In this 
situation, the unit will override the 
fixed callback and it will provide 
roaming callback to the user. See 
Section Configuring PPP. 

In both situations the unit will require 
the user to log in again (a security 
precaution). 



framed ip. 



(use only when the user service field is set to 'slip' or 'ppp') this is the ip address of the 
remote user. Enter the address in dot decimal notation as follows: 

255.255.255.254 (default) - if you enter this value, the unit will use the remote ip address 
set for the line; see Section Configuring SLIP or Section Configuring PPP. 
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255.255.255.255 (when user service is set to 'ppp') - if you enter this value the unit will 
allow the remote machine to specify its ip address; (it therefore overrides the parameter 
'ip address negotiation' which you can configure for PPP). 

255.255.255.255 (when user service is set to 'slip') - if you enter this value the unit will 
use the remote ip address set for the line (no negotiation). 

n.n.n.n - (where n is a number); enter an ip address of your choice. This ip address will then 
be used in preference to the remote ip address set for a line. 

framed netmask. (use only when the user service field is set to 'slip' or 'ppp'). If the remote user is on a 

subnet, enter the subnet mask. This field is for your information only; it is not processed 
by the software. 

framed mtu. (use only when the user service field is set to 'slip' or 'ppp') This field specifies the 

maximum size of packets in bytes being transferred across the link. On noisy links it may 
be preferable to fragment large packets being transferred over the link since there will be 
quicker recovery from errors. Depending on whether you have selected a user 'service' of 
SLIP or PPP, details are as follows: 

for PPP, framed mtu will be the maximum size of packets that the the unit port will accept. 
This value is negotiated between the two ends of the link. The default value is 1500 bytes. 
Enter a value in bytes in the range 64-1500. An example value is 512 bytes; this will 
restrict the unit to accepting packets no greater than 5 12 bytes in length. 

for SLIP, framed mtu will be the maximum size of packets being sent by the unit. The unit 
will send SLIP packets in the range 256-1006 bytes. The default value is 256 bytes. An 
example setting is 5 12: this will restrict the unit to sending SLIP packets no greater than 
512 bytes in length. 

The framed mtu value will be used in preference to the mtu/mru values set for a line; see 
Section Configuring SLIP or Section Configuring PPP. 



framed compression. 

(use only when the user service field is set to 'slip' or 'ppp') this parameter determines 
whether Van Jacobsen Compression is used on the link. Select either 'on' or 'off (default 
is 'off'). VJ compression is a means of reducing the standard TCP/IP header from 40 
octets to approximately 5 octets. This gives a significant performance improvement 
particularly when interactive applications are being used. Such an application is typing, 
where a single character can be passed over the link with a 40 octet header attached. VJ 
Compression has little effect on other types of link, such as ftp, where the packets are 
much larger. 

The framed compression value will be used in preference to the VJ compression values set 
for a line; see Section Configuring SLIP or Section Configuring PPP. 

3. Press <return> to exit; accept or discard the form as you wish. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 

Note Changes you make in this form, as the system administrator, will only take effect for a user when the user 
next logs in to the unit. 

If you set up any restricted users, you must predefine their sessions; they can only open sessions predefined 
for them by the admin user (see "Predefine User Sessions" section). 
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User Levels 

There are four user levels which can be used to determine the level of access the user has to JETSTREAM 
4000, 8500 or LANSTREAM 2000 commands: 

Admin the system administrator. The admin user has total access to the unit. You can create more 

than one admin user account but we recommend that you only have one. 

Normal (default) normal users have access to the Sessions menu only. They can start sessions, predefine 
sessions and change their own user environment. 

Restricted these users have access to a restricted Sessions menu; they can only open sessions 

predefined for them by the admin user. Predefined sessions can even be configured to start 
automatically at login. 

Menuing only be able to initiate sessions defined for that user. All other functionality is barred. 

Tip You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



CLI prompts 

For admin users, the cli prompt is followed by a hash sign, for example JS_8500#. For normal and restricted 
users the prompt will be followed by a dollar or pound sign, for example JS_8500$ (or JS_8500£). The 
display of a dollar or pound sign will vary according to the characters supported by your terminal. 



Running Sessions 

Note This section applies to using the unit as a Terminal Server. See Chapter 1 (Configuring a Line: Terminal 
Server Connections) 

Users who have successfully logged into the unit (user service set to 'jsprompt') can start up to four login 
sessions on TCP/IP hosts. These users start sessions through the menu option 'Sessions'; see Section 
Running Sessions. 

Multiple sessions can be run simultaneously on the same host or on different hosts. Users can switch 
between different sessions and also between sessions and the unit using hot-key commands; (see Section 
Hot-key Commands). 

Users with a privilege level of 'admin' and 'normal' can predefine sessions, even configure them to start 
automatically on login to the unit. Users with a privilege level of 'restricted' can only start sessions 
predefined for them by you as the system administrator; see Section Predefining Sessions. 



Predefine User Sessions 

cli syntax: This option enables you to predefine up to four sessions for any user. You must predefine at least one 

set user session for each restricted user because they can only open predefined sessions. 

Select 'Set Sessions' from the Users menu. Select a user from the list displayed and press <return>. The 
Sessions form will be displayed: 
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Set Sessions 






Session 


1 


2 


3 


4 


TvD G 


[off ] 


[off ] 


[off ] 


[off ] 


Hostname 


[ socrates 


[socrates ] 


[socrates 


[socrates ] 


Termtype 


[ ] 


[ ] 


[ ] 


[ ] 


Auto 


[off ] 


[off ] 


[off ] 


[off ] 


Echo 


[off ] 


[off ] 


[off ] 


[off ] 


Mapnl 


[off ] 


[off ] 


[off ] 


[off ] 


Mode 


[off ] 


[off ] 


[off ] 


[off ] 


I nt r 


[7f ] 


[7f ] 


[7f ] 


[7f ] 


Quit 


[lc ] 


[lc ] 


[lc ] 


[lc ] 


EOF 


[4 ] 


[4 ] 


[4 ] 


[4 ] 


Erase 


[8 ] 


[8 ] 


[8 ] 


[8 ] 



Tip 



These are the default settings. The fields after 'Auto' are telnet options. 

Type 'off, 'telnet' or 'rlogin'. When not set to 'off, a predefined session will use up one of the 

user's 4 session slots whether active or not. 

Hostname you can only predefine sessions on hosts defined in the host table. The first entry in the 
host table will be entered as the default. 

Termtype when connecting to a UNIX host, you must define your terminal type in accordance with 

its UNIX TERM variable. 

Auto If this field is set to 'on', the session will start up automatically when the user logs on. 

When more than one session is set to autostart, session 1 will be displayed first. If this field 
is set to 'off, the session must be started using the 'Start Predefined Sessions' option on 
the Sessions menu. 

You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



Effect of Timers on Sessions 

There is one idle timer and one session timer which apply to all sessions for a particular user. The respective 
timers are either: 

• the line idle and session timers, (see Login direct to host on page 20) 
or, if set, 

• the user idle and session timers (see Configure a User Account on page 82) 
The user timers take precedence over the line timers. 



Change a User's Password 

cli syntax: Select 'Set Password' from the Users menu, 

sot user 

Select a user from the list displayed. 

You will be prompted to enter a password. This can be up to sixteen characters long (do not use spaces). 
Use the <del> key to backspace if necessary. Enter the password and press <return>. 
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Tip 



When prompted, re-enter the password and press <return>. 
The password change will take effect next time the user logs in. 

You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



Delete a User Account 



cli syntax: 
delete user 



You will be unable to delete the default admin user, users that are logged in or users dedicated to a specific 
line. 



Select 'Delete User' from the Users menu. 



Select the user that you want to delete from the list displayed. 

You will be asked to confirm the deletion; type 'y' and press <return>. 
The user will be deleted. 



Tip 



You may want to save your configuration changes permanently; see Section Save to non-volatile memory. 



Language support 



This section gives you additional information about the languages you can use in the text menus/cli. 

You have five other language files supplied on the supplemental diskette/CD: French, German, Italian, 
Spanish and Mandarin. Additionally you can use any of these language files to obtain a translation into a 
language of your choice. You download the language file (whether the language is supplied or translated) 
into the unit. You select the language option of 'customlang' (i.e. custom language); the text menus and cli 
then display in your language. 

You can view menus/cli in one other language only (as well as English). If you download another language 
file, this new language will replace the first language you downloaded. 

You can revert to English at any time; the English language is stored permanently in the unit and is not 
overwritten by your new language. 

Each user logged into the unit can operate in a separate language; i.e. user A in English, User B in the 
'customlang', etc. 



French, German, Italian Spanish and Mandarin language files are provided on the supplemental diskette/CD. 
To load one of these four languages into the unit - so that the text menus and cli appear in the language - do 
the following: 

1 . Open the supplemental diskette/CD and identify the language file; the files have intuitive names; e.g. 
'french.txt' 'deutsch.txt', etc. 

2. Copy the language file to a host machine on the network; place it in the main file system or on the 
main hard drive. 



Other Supplied languages 
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Either: use the TFTP defaults in the unit or, configure as necessary, TFTP in the unit; see Section 
TFTP configuration. 

In the cli of the unit enter your hostname and filename; e.g 

netload customlang socrates /temp/f rancais . txt 

Do not enter a drive letter! Also, the path and/or filename must begin with the 'forward slash' 
chararacter / 

The unit will download the language file via TFTP. 

To set an individual user to the new language, go to to the Users menu and, in the language field 
select 'customlang'. In the cli (only) you can set individual users or all users to the new language; see 
the set user * command. 

The user will see the change of language when he/she logs out (Main Menu - Sessions Menu - logout) 
and logs back into the unit. If, as Admin user, you change your language setting to 'customlang', you 
will see the text menus display in the new language when you save and exit the 'Change User' form. 

Notes on the supplied languages: 

If you download a new software version, you can continue to use your language unchanged; however, 
we recommend translating the new strings - see Section Effect of Software upgade on Language Files. 

A Factory Reset will reset the 'customlang' to English (factory default language). 

On successful download the customlang in the unit will be overwritten by the new language. 

Language of your choice 

In addition to English or one of the supplied languages (see Other Supplied languages on page 89) you can 
display the text menus and cli in any language of your choice. Your language may use a different alphabet. 
Using one of the ascii language files provided on the supplemental diskette/CD you obtain a translation into 
your preferred language. You then download the new language file by TFTP into the unit. This new 
language becomes the 'customlang' (custom language). 

In detail you do as follows: 

1 . open the supplemental diskette/CD and identify the language file which you will use for the 

translation. The language files contain a list of text strings which appear in the text menus and cli. An 
example of some text in an English language file is shown below: 



all lines 

arbitrary tcp port 

alter your security level to admin 

download extra language file 

hostname/web address 

host port 



cli syntax: 4. 
netload 



set user 



logout 
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ine number 
ine settings 

UETSTREAM/LANSTREAM address 



For further guidance on translating a language text file, see Section Translation guidance. 

2. Choose a name for your new language file. 

3 . Copy the language file to a host machine on the network; place it in the main file system or on the 
main hard drive. 

4. Either: use the TFTP defaults in the unit or, configure as necessary, TFTP in the unit; see Section 
TFTP configuration. 

cli syntax: 5. In the cli of the unit enter your hostname and filename; e.g 

netload netload customlang socrates / temp/ our 1 ang . txt 

Do not enter a drive letter! Also, the path and/or filename must begin with the 'forward slash' 
chararacter / 

The unit will download the language file via TFTP. 

set user 6. To set an individual user to the new language, go to to the Users menu and change their language to 

'customlang'. In the cli (only) you can set individual users or all users to the new language; see the set 
user * command. 

logout 7. The user will see the change of language when he/she logs out (Main Menu - Sessions Menu - logout) 

and logs back into the unit. If, as Admin user, you change your language setting to 'customlang', you 
will see the text menus display in the new language when you save and exit the 'Change User' form. 

Notes on the customlang feature: 

If you download a new software version, you can continue to use your translated language unchanged; 
however, we recommend translating the new strings - see Section Effect of Software upgade on 
Language Files. 

A Factory Reset will reset the customlang to English (factory default language). 

On successful download the customlang in the unit will be overwritten by the new language. 



Translation guidance 

To help you with your translation of supplied ascii text language files we offer the following guidance: 

1. The unit will support alphabets other than English, up to a maximum of 128 characters 

2. translate line for line: do not omit lines if you do not know the translation; leave the original 
untranslated text in place 

3. maintain the same sequential order of lines; i.e. if 'all lines' is followed on the next line by 'arbitrary 
tcp port', do the same in your translated file 
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4. if a line contains only numbers, e.g. 38400, leave that line in place, unchanged (unless you are using a 
different alphabet) 

5. if you are unsure how many characters are allowed on a line, see other text files on the supplemental 
diskette/CD; these files should give you guidance on line lengths. Restrict your translations of each 
line to the maximum number of characters allowed on that line 

6. terminate each line with a carriage return 



Effect of Software upgade on Language Files 

If you receive a software upgrade for the unit, the language files supplied on the supplemental diskette/CD 
may also have been updated. We will endeavour to provide a list of those changes in another text file on the 
same supplemental diskette/CD. 

Note The upgrade of your software will not change the display of the language in the text menus/cli. 

If you are already using one of the supplied languages (French, etc.) you may want to update the language 
file in the unit's memory; follow the steps detailed in Other Supplied languages on page 89. Until you update 
the unit's memory, new text strings (e.g. for a new parameter) will appear in English. 

If you are already using a language translated from an earlier version of one of the supplied language files 
you may wish to amend your translation. When a language file is updated we will try to maintain the 
following convention: 

1. new text strings (e.g. a new parameter) will be added to the bottom of the file (not inserted into the 
body of the existing file) 

2. existing text strings - if amended - will be amended in situ; i.e. in their current position in the file 

3. the existing sequence of lines will be unchanged 

4. until you have the changes translated, new text strings will appear in the menus/cli in the default 
language (English) 



Save to non-volatile memory 

When you exit a text menu screen (form) after making changes, you will be presented with the 'options' 
form: 



options 

accept and exit form 

If you choose to 'accept and exit form' your changes will retained in RAM (volatile memory). 

To save your changes permanently you will need to exit the text menu system completely. Return to the 
Main Menu and select 'command line mode'; you will be presented with a form: 
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exit full screen mode 



exit and save changes 

exit without saving changes 

return to main menu 

Choose 'exit and save changes'. All the changes made since last entering the menus will be saved to FLASH 
(permanent, non-volatile) memory. 

You will now be at the command line prompt. To return the menus type: 
screen 

Saving to a file 

cli syntax: You can also save your configuration information to a file on a host. This can only be done in 

netsave the cli; see Section netsave. 
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Chapter 5 System Administration & 
BOOTP 



Introduction 

This chapter describes the other major tasks that you - as the system administrator - may need to perform. It 
is divided into the following sections: 

• Becoming Admin User 

• Upgrading System Software 

• Downloading Terminal Definitions 

• TFTP configuration 
BOOTP 

• DHCP Configuration and Operation 

• Rebooting 

• Resetting to Factory Defaults 

• Remote Configuration 

• Security 

• Off-line Configuration 

• Save Configuration to a file 

• Lost Password 



Becoming Admin User 

normal Command: This menu option enables you to become an admin user, if you know the admin password. Prior to this 
admin action you must be a 'normal user' (the default); select 'Become Admin User' from the Sessions menu. 

You will be asked to enter the admin user password: 

| Enter Password: | 

You will then be logged in as the admin user. The full main menu will be displayed. Note that you cannot 
become a normal user unless you log out and log back in again. 
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Upgrading System Software 

Follow the instructions in the JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, Section 
Software Upgrade. 

Note that you can configure TFTP in the unit; see Section TFTP configuration. 
When you have upgraded the software, existing passwords will be unchanged. 



Downloading Terminal Definitions 



All terminal types can be used on the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit'). 
Terminal types which are not defined on the unit, however, are unable to use Full Screen mode (menus) and 
may not be able to page through sessions properly. When installed, the unit has three defined terminal types 
- Wyse60, VT100 and Ansi. 

If you are not using, or cannot emulate, any of these terminal types, you can add up to three additional 
terminal definitions to the unit. The terminal definitions can be downloaded from a TCP/IP host. 

Three sample terminal definitions are supplied on the Supplemental disk/CD supplied with the unit. These 
areTVI950, IBM3161 and Adds Viewpoint. 

To download terminal definitions, follow these steps: 

1 . Decide which TCP/IP host you are going to use. It must be a UNIX machine and must have tftp 
enabled. 

2. Configure tftp in the unit as necessary; see Section TFTP configuration. 

3. Tar the sample files from the Supplemental disk/CD onto the boot host. They are called 
ET.tvi950, ET.addsvp and ET.ibm3161. Copy them to a directory of your choice. Make sure 
they have global read and execute permission for their entire path. 

4. If you need to create your own terminal definition files, refer to Creating Terminal Definition Files on 
page 97. Copy them to a directory of your choice. Make sure they have global read and execute 
permission for their entire path. 

Note if you are using tftp with the secure option, i.e. "tftpd -s /tftpboot ", create a directory under /tftpboot/ and 
place the term files in this directory. 

cli syntax: 5. Exit the menus, go into the cli and use the netload command; refer to netload on page 165 for 

netload information on this command. 



set line 6. You can stay in the cli or re-enter the menus. In the menus go to the line configuration menu, then the 

line settings sub-menu and select a particular line. From the line parameters displayed go to the 
'terminal' field and press L (for 'list'; upper or lower case). You should see: 




JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



96 



perfe 



7. select one of terml, term2 or term3; (these definitions default to Wyse60). Your downloaded 
terminal definition is either 'terml', 'term2' or 'term3' (as specified when you used the 
'netload' cli command). 

8. To copy this new term type to all other lines, press <return> and follow the screen prompts. See Copy 
settings to other lines on page 26 for more information. 

Tip If you have problems using arrow keys using a downloaded terminal definition, you can use Ctrl-K, Ctrl- 
J, Ctrl-H and Ctrl-L for up, down, left and right respectively. 



Creating Terminal Definition Files 

To create new terminal definition files, you need to copy and edit the information from the terminfo 
database. 

1 . On the UNIX host, change directory to /usr/lib/terminfo/x (where x is the first letter of the required 
terminal type). For a Wyse60, for example, you would enter the command cd /usr/lib/terminfo/w 

2. The termcap files are compiled, so use the command infocmp termfile to read the required file (for 
example: infocmp wy60). 

3. Check the file for the attribute xmc#n (where n is greater than or equal to 1). This attribute will 
corrupt menu and form displays making the terminal type unsuitable for using Full Screen mode. 

4. If the terminal definition is suitable, change to a directory of your choice. 

5. Rename and copy the file to the directory specified at step 4. using the command infocmp termfile > 
termn where n is greater than or equal to 1; (e.g. infocmp wy50 > terml). Make sure the file has 
global read and execute permission for its entire path. 

6. Edit the file to include the following capabilities in this format: 

t e rm = 
ac sc = 
bold = 
c i vi s = 
clear= 
cnorm= 
cup = 
rev = 
rmac s = 
rmso = 
smacs = 
smso = 
page = 
c i r c = 



For example: 



term=AT386 | at386| 386AT|386at 


| at/386 console 


acsc=jYk?lZm@qDtCu4x3 




bold=\E [lm 




c i vi s = 




clear=\E [2 J\E [H 
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cno rm = 

cup=\E [%i%pl%02d;%p2%02dH 

rev=\E4A 

rmac s = \E [10m 

rms o= \ E [m 

smac s = \ E [12m 

smso=\E [7m 

page = 

circ=n 



Note As you can see from the example, capabilities which are not defined in the terminfo file must still be included 
(albeit with no value). Each entry has an 80 character limit. 

On some versions of UNIX, some of the capabilities are appended with a millisecond delay (of the form 
$<«>). These are ignored by the unit and can be left out. 

The 'acsc' capability, if defined, contains a list of character pairs. These pairs map the characters used by 
the terminal for graphics characters to those of the standard (VT100) character set. 
Include only the following character pairs: 

jx, kx, Ix, mx, qx, tx, ux and xx 

(where x must be substituted by the character used by the terminal). These are the box-drawing characters 
used to display the forms and menus of Full Screen mode. They must be entered in this order. 

The last two capabilities will not be found in the terminfo file. In the 'page' field you must enter the escape 
sequence used by the terminal to change screens. The 'circ' field defines whether the terminal can use 
'previous page' and 'next page' control sequences. It must be set to 'y' or 'n'. These capabilities can be 
found in the documentation supplied with the terminal. 

TFTP configuration 

Cli syntax: You can configure TFTP in the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit'), It is used 

set server tftp for transferring files to/from a host; the files could be, for example, configuration, new software or custom 
language files. From the Network Configuration Menu, select 'tftp'; you should see the following: 




retry should tftp fail, retry is the number of retries the unit will make to transfer a file to/from a 

host. Enter a value between 0 and 255. The default value is 5. A value of 0 means that the 
unit will not attempt a retry. 

timeout is the time in seconds the unit will wait for successful transmit or receipt of tftp packets 

before retrying a transfer. Enter a value between 1 and 255. The default value is 3. 
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BOOTP 

5.0.0.1 Contents of BOOTP section 

• Overview 

How to setup BOOTP, 
the bootptab file entry 
the bootfile 

• BOOTP messages output to screen 
Disabling the BOOTP reply 

• Booting multiple units 
Multiple BOOTP servers 
Example of BOOTP 



Introduction 

You can use BOOTP to perform the following actions on a single or multiple JETSTREAM 4000, 8500 or 
LANSTREAM 2000 (the 'unit(s)')s on its/their boot-up: 

• auto-configure with minimal information; e.g. only an ip address 

• auto-configure with basic setup information (ip address, subnet mask, broadcast address, etc.) 

• download a new version of software 

• download a full configuration profile (saved from another unit) 

BOOTP is particularly useful for multiple installations: you can do all the unit's configuration in one 
BOOTP file, rather than configure each unit manually. 

Another advantage of BOOTP is that you can connect a unit to the network, turn on its power and let auto- 
configuration take place. All the configuration is carried out for you during the BOOTP process. 

The the unit's implementation of BOOTP is compatible with RFC 951; see Appendix D (References) for 
detail on this RFC. 



Overview 

On bootup or power-up, the unit will send a broadcast request to the BOOTP server(s) on the network. The 
request contains the ethernet address of the unit; it asks for network configuration details (internet address, 
subnet mask, etc.). This process is shown in Figure 17. 

You can stop the BOOTP server from replying to the unit; see Disabling the BOOTP reply on page 106 
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Figure 17 BOOTP request and response 



either: 

the BOOTP server 
finds a matching 
ethernet address 
and sends a 
reply to the 
Specialix unit 



or: 

the BOOTP server 
does not find a 
matching ethernet 
address; 
it does not 
reply to the 
Specialix unit 





BOOTP 
server 




if there is a 
BOOTP reply 



JETSTREAM 
(any model), 
or LANSTREAM 



(booting up) 




BOOTP request 



The BOOTP server checks the ethernet address and looks for a matching address in its bootptab file: 

- if a matching ethernet address is found the BOOTP server will reply to the unit; the reply will contain 
network configuration information. This information is listed in the bootptab file for that particular unit 
(identified by its hardware address). The unit then boots using the information sent to it. 

- if no matching ethernet address is found the BOOTP server does not reply; the unit boots from internal 
memory. 

Refer to Figure 18 for an explanation of the following text: 

the BOOTP response contains network configuration information; e.g. ip address, subnet mask, 
broadcast address. It may also contain details of a bootfile (not mandatory) 

a bootfile (if you specify one) contains a unit's specific boot information; e.g. authentication method of 
users, access permission for the GUI. It may also contain details of other files (not mandatory); e.g. 
software version, language files and a general configuration file 

a configuration file (if you specify one) contains general configuration parameters; these parameters 
will have been created from another unit and saved to a file 

in the bootp response the minimum parameters to specify are :ht and :ha 

there is no minimum number of parameters to specify in the bootfile or configuration file; unspecified 
parameters will remain unchanged in the unit's memory 

After processing the BOOTP response the unit will download additional files, as follows: 

if a bootfile is specified, the unit will then download that bootfile (using tftp). 
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Note 
Figure 18 



if the bootfile specifies other files e.g. a software file, the unit will compare that filename with the 
filename in its memory; if it has changed the unit will then download that other file using tftp. If the 
filename has not changed the unit will not download it. 

In the bootp response you do not have to specify a bootfile. In the bootfile you do not have to specify other 
files, such as the software file. If you wish, you can make an entry in the bootptab fde only. 

the files used in the BOOTP process 



Entry for the unit in bootptab 
file... 



js8500_blue:\ 
ht=1:\ 

ha=0080ba000057:\ 
bf=/tmp/8500p.bfc:\ 

ip=192.101 .34.211 :\ 
ds=192.65.144.44:\ 
sm=255.255.255.224:\ 
hn:\ 

dn=perle.com:\ 
gw=192. 101. 35.254 :\ 
vm=rfc1048: 



Bootfile named '8500p.bfc'. 



#cat 8500p.bfc 




GULACCESS 


yes 


SECURITY 


no 


AUTHJTPE 


0 


IPJiOST 


192.101.34.199 


TFTP_RETRY 


3 


TFTP_TMOUT 


21 


CUSTOMJ.ANG 


SWEDISH 


EXTRA_TERM1 


192.65. 144.95:/src/pscx/et/et1 .0183 


EXTRA_TERM2 


192.65. 144.95:/src/pscx/et/et2.0183 


EXTRA TERM 3 


1 92 .65 . 1 44 . 95 :/s rc/pscx/e t/et3 .0 1 83 


SW_FILE 


1 92.65.1 44.95:/src/pscx/js8500.bin 


CONFIG FILE 


1 92.65.1 44.95:/src/pscx/cfg/jconfig.01 



software file js8500.bin.... 



compiled software for loading into 
FLASH memory on the unit 



configuration file config .01.... 



a copy of the configuration 
parameters saved from a unit onto 
a host; excludes parameters 
unique to the original unit. 
This file can be downloaded to any 
unit. 
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How to setup BOOTP 

Your nominated BOOTP server should be on the same network as the the unit(s). The BOOTP server can 
also be on a different segment of the same network, provided that segment is connected by a bridge. 

You can locate your BOOTP server on another network to the unit; this means that the bootp request and 
replies have to pass through a router or gateway. You must configure your router or gateway: 

• to pass through BOOTP requests and replies 

• for RIP 

Note that if you have an existing unit, you do not have to enter the details of the gateway or router into the 
unit before using bootp. Details of gateways or routers pre-configured in the unit will be ignored during the 
bootp process. 



5.0.0.2 the bootptab file entry 

Find the bootptab file on the host; on UNIX systems the bootptab file is usually file /etc/bootptab. Make an 
entry for the unit; an example for a single unit is shown at Figure 19. An example for multiple units is shown 
at Figure 2 1 . 



Figure 19bootptab file entry for a single unit 



js8500_blue:\ 
ht=1:\ 

ha=0080ba000057:\ 

ip=192.101.34.211:\ 

ds=192.65.144.44:\ 

sm=255.255.255.224:\ 

hn:\ 

bf=/tmp/8500p.bfc:\ 
dn=perle.com:\ 
gw=192. 101. 35.254 



This entry should include the ethernet address of the unit. 
Other standard BOOTP tags which the unit supports are 
listed below, together with the unit's interpretation: 



ht (hardware type) set to 1 (=10Mb ethernet). 

ha (hardware address) the ethernet address of the unit. 



ip (internet address) enter the ip address to assign to the unit. 

sin (subnet mask) enter the subnet mask of the unit. 

hn (host name) enter as :hn:\ which causes the name at the start of the 

file (js8500_blue) to be allocated to this unit. 

bf (bootfile name) enter the name of the file containing specific 

configuration information; see Figure 20. 

ds (domain servers)enter the ip address of up to two nameservers. 
gw (gateway)enter the ip address of a single passive gateway 
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Caution 



use the 'gw' flag only in very specific circumstances; see Note 5. below. 



Notes on the above BOOTP tags: 

1 . Specify the fields that you wish; you do not have to specify all of them. E.g. if you wish to download 
only the internet address to the unit, specify the ip field (you must specify - as a minimum - the ha 
and ht fields). 

2. If the subnet mask (sm) has not been explicitly specified by a BOOTPREPLY packet, it will be 
derived from the class of internet address. 

3. If domain name servers are specified their port number will always be set to the default for a name 
server (53). 

4. If you require a bootfile (bf) it must be on the same host as the bootptab file entry. 

5 . include the gw (gateway) flag only if your BOOTP server is on a different network and your gateway 
(or router) is not configured to support RIP. 

The effect of using the 'gw' field is: 

- to make only this gateway available in the unit; it will be a passive gateway. You can view the details 
of the gateway only in the cli, using the 'show routes' command. 

- to turn off RIP in the unit; i.e. the unit will ignore RIP messages broadcast on the network 

- the unit will ignore gateways pre-configured in the unit or added after boot-up. It will respond only to 
the single gateway. 

- you delete the gateway as follows: omit the 'gw' field in the bootptab file entry and re-boot the unit. 
You can now add/configure active and passive gateways into the unit. 

Gateways are detailed in the 8500 Installation Guide, Chapter 2 (Initial Set-up). An overview of RIP is given 
in Appendix D (RADIUS & Networking) of the same Guide. 

5.0.0.3 the bootfile 

If you wish to download basic configuration information to the unit you must create a bootfile. This file 
is a text file formatted in a particular style; an example is shown at Figure 20. 



Note 



The bootfile must be located on the same host as the bootptab file 
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Figure 20 

An example bootfile 



# cat 8500p.bfc 



SW_FILE192.65.144.95:/src/pscx/sw/js8500.bin 

CONFIG_FILE192.65.144.95:/src/pscx/cfg/jconfig.0183 

GULACCESSyes 

AUTH_TYPE0 

IP_HOST192.101 .34.199 

SECURITYno 

TFTP_RETRY3 

TFTP_TMOUT21 

CUSTOM_LANG192.65.144.7:/etc/js/config/js8500_blue/polish 
EXTRATERM 1 1 92 .65. 1 44.95 :/src/pscx/et/et1 .0 1 83 
EXTRA_TERM2192.65.144.95:/src/pscx/et/et2.0183 
EXTRA_TERM3192.65.144.95:/src/pscx/et/et3.0183 



# 



Notes on the above example: 

1. The bootfile can have line entries for other files, e.g. a software or configuration file. The unit will 
download these files only if the filename has changed (excludes the pathname). 

2. The format of each line entry in the file is: 

PARAMETER_NAME <white space> parameter value 
<carriage return/line feed> 

3. The parameter name must be in UPPER CASE and match exactly the strings shown in Figure 20; e.g. 
AUTH_TYPE and CUSTOM_LANG. 

4. An explanation of these parameters is shown in Table 3. 

5. Include only those parameters which you want to configure. For example you may not wish to 
download a configuration file, so omit the line beginning CONFIG_FILE (or precede the line with a 
hash # character). 

6. If a domain name and nameserver are configured, either in the bootptab entry or in the unit's memory, 
you can replace ip addresses with hostnames in lines specifying additional files; e.g. 

SW_FILEsophocles : / src/pscx/sw/ j S8500 .bin 



Table 3Bootfile parameters 



Parameter 



Value 



Brief Meaning 



Fuller explanation 



SW_FILE 



a filename and a full a version of software 8500 Installation Guide, 
pathname Section Using TFTP 

- all pre-fixed by from a host 

hostname/ip address 
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Parameter 



Value 



Brief Meaning 



Fuller explanation 



CONFIG FILE 



AUTH TYPE 



IP_HOST 



SECURITY 



a filename and full 

pathname 

- all pre-fixed by 

hostname/ip address 



GULACCESS on, off 



both, local or radius 



ip address in dot 
decimal notation 



on, off 



TFTP_RETRY numeric; e.g. 5 



TFTP_TMOUT numeric; e.g. 3 



CUSTOMJ.ANG 



a filename and full 
pathname pre-fixed 
by hostname/ 
ip address 



a set of saved 
configuration 
parameters from an 
existing unit. Note: 
these parameters 
include user 
passwords. 



access to the unit 
from a web browser 



authentication method 
employed by the unit 
for all users 

default ip host for a 
user when user 
service is set to 
'telnet' 'rlogin' or 
'tap clear' 

'reverse' line types, 
'printer' line type and 
remote configuration - 
all restricted to 
devices listed in the 
the unit's host table 

number of tftp 
attempts before 
aborting 

period in seconds 
before retrying a 
download/upload 

name of a translated 
language file 



configuration parameters 
which are not listed in the 
BOOTPTAB file entry or 
in the bootfile. The 
relevant configuration 
parameters are listed in 
Section netsave. The 
parameters will not 
overwrite network 
configuration parameters 
specified in your bootfile. 

8500 Installation Guide, 
Section Initial 
Configuration 

8500 Installation Guide, 
Section Initial 
Configuration 

Section Configure a 
User Account 



Section Security 



Section TFTP 
configuration 

Section TFTP 
configuration 

Section Language of 
your choice 
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Parameter 


Value 


Brief Meaning 


Fuller explanation 


EXTRA_TERM1 


a filename and full 


termcap files for 


Section Creating 


(or 2, or 3) 


pathname - all 


specific terminal types 


Terminal Definition Files 




prefixed by a 








hostname/ip address 







BOOTP messages output to screen 

The unit will output BOOTP messages to your screen during bootup, provided you are connected to the unit 
via its Admin Port. Information on using the Admin Port is detailed in the 8500 Installation Guide, The 
Admin Port on page 37. 

On bootup the unit will always send a BOOTP request to BOOTP servers, so you will see the message: 
INIT: attempting BOOTP 

If the unit does not receive a BOOTP reply you will see the message: 

INIT: no bootphost/ server found on this network 

If you want the unit to boot from a BOOT server then this message means BOOTP is not working. Consult 
Section BOOTP/DHCP problems for help. 



Disabling the BOOTP reply 

You cannot disable BOOTP in the unit; however, you can stop the BOOTP host from sending a BOOTP 
reply to the unit. You stop the reply by placing a hash # character in the bootptab file entry as follows: 

• in Figure 19, place a hash before all the lines, e.g. 
#:ht=1:\ 

• :ha=0080ba000057:\ 
#:gw=192.101.35.254:\ 

• in Figure 21 you would place a hash before the line referring to each JETSTEAM; e.g: 

# j S8 50 0_2 :ht = l :ha=0 0 8 0ba000 02 5 : \ 

# ip=192 . 101 . 34 . 194 : tc=common : 



Booting multiple units 

You can boot mutliple unit's simultaneously using BOOTP; we recommend you alter the format of your 
bootptab file entry, as shown in Figure 21. You make one set of parameters in a single area (in this example 
'common') and point each unit's entry to this area called 'common'. 
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Figure 21 bootptab file entry for multiple units 

common is the collective 

name for the list of ►common : \ 

information in this file 

:bf=/usr/js/js8 50 0p. cus : \ 
: sm=255 . 255 .255 .224 : \ 
:hn:\ 

: dn=perle . com: \ 
:ds=192 . 101 . 34 .211 

js8500_l is the name of 

the first JETSTREAM s850 0_l:ht = l:ha=0080ba000024:\ 

: ip=192 .101.34.193: tc=common: 

js8500_2 is the name of 

the second JETSTREAM ► js850 0_2:ht = l:ha0080ba000025:\ 

: ip=192 .101.24.194: tc=common: 



ethernet addresses 
of JETSTREAMs 

to=common, means: ^ 
use all the information listed 
under "common:\" 




Notes on the above figure: 

1 . The example shown is for the JETSTREAM 8500. 

2. List each unit at the bottom of the file. 

3. So that all units use the same BOOTP information, terminate each unit's entry with the same syntax, 
using the format tc=name (in the example above tc=common). 

4. You will see that all the unit's are being directed towards the same bootfile (as listed in the 'bf field 
in the area 'common'). This is acceptable - however all your the unit's will have the same 
configuration parameters. 

5 . The bootfile must be on the same host as the bootptab file entry. 



Multiple BOOTP servers 

You may well wish to have a secondary BOOTP server as a back-up to the primary BOOTP server. 

The unit will operate with BOOTP when you have a second, third or more BOOTP servers on your 
network. During a reboot the unit processes the first BOOTP reply received and ignores subsequent replies. 
If the bootptab file entries are identical on all your BOOTP servers the first reply received by the unit will 
be the same as the other replies. 

The rules for multiple BOOTP servers are: 
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• we recommend they are located on the same network; however if they are on different network see the 
advice at How to setup BOOTP on page 102 

• if you specify a bootfile (bf), each BOOTP server must contain an identical copy of this bootfile 

• the software file (SW_FILE) and/or configuration file (CONFIG_FILE) can be located on any host; 
they do not have to be on the BOOTP server machines 



Example of BOOTP 

Here is a working example of BOOTP, used to download a new version of software. We are using tftp with 
the 'secure' option: 

1. If possible choose a BOOTP server which is located on the same network as the unit. Our BOOTP 
server was located like this. 

2. Enable BOOTP on the machine you have chosen as the BOOTP server. E.g. on our SCO Open 
Server 5 machine we modified file /etc/inetd.conf, as follows: 

tftp dgram udp wait root /etc/tftpd tftpd -s /tftpboot 

bootps dgram udp wait root /etc/bootpd bootpd -c/tftpboot 

3. Reboot the BOOTP server to ensure that BOOTP is operating. 

4. Make an entry in file /etc/bootptab for your unit; e.g. 



Figure 22 

Our example entry in a BOOTPTAB file 



js8500_3:\ 




ht=1:\ 




ha=0080BA00004b:\ 




ip=192.65.146.120:\ 




ds=192.165.144.6:\ 




sm=255.255.255.0:\ 




hn:\ 




bf=/test:\ 




dn=specialix.co.uk 



5. Create the bootfile specified in the above entry; i.e. file 'test': 
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# cat test 

SW_FILE192.65.146.71:/js8500.fls 

GULACCESSyes 

AUTH_TYPEO 

IP_HOST192.65.146.71 

SECURITYno 

TFTP_RETRY3 

EXTRA_TERM 1 homer:/src/pscx/et/et1 .0 1 83 
EXTRA_TERM2homer:/src/pscx/et/et2.0183 
EXTRA_TERM3homer:/src/pscx/et/et3.0183 

# 



6. In the bootfile (above) we specified the software file(SW_FILE). Specify the pathname for the file; in 
our example we placed the software file in the same directory as the bootfile. 

7. Reboot the unit. After receiving details from the bootptab file, the unit should download the bootfile 
and the software file. The unit should then place the new software file into FLASH memory. 



DHCP Configuration and Operation 

The DHCP protocol provides an industry standard alternative to BOOTP and provides a more sophisticated 
method of managing IP addresses and configuration parameters. It should be particularly useful when 
managing the unit from a Windows NT server environment and some versions of UNIX such as UnixWare 
7. 

DHCP is a superset of the BOOTP configuration service which it completely replaces. DHCP is backward 
compatible with BOOTP in that the entire suite of BOOTP tags is supported within DHCP. DHCP is now 
often used in favor of BOOTP as it is supported on a wide range of network operating systems, however to 
ensure compatibility with existing installations, the JETSTREAM 4000, 8500, or LANSTREAM 2000 (the 
'unit') will continue to fully support BOOTP. 

The major differences between BOOTP and DHCP are: 

• BOOTP is largely reliant on a network client's low level Ethernet address ( MAC address ) for client 
information look-up, DHCP has no such limitation, although it is still possible to associate a specific 
IP address to a specific MAC address. 

• Client information supplied by DHCP is supplied on a lease basis, that is to say that the client 
negotiates with the server for the lease of an IP address for a specific period of time. This allows for 
the allocation of a fixed pool of client addresses that are allocated by the DHCP server on a "first come 
first served" basis. 

No additional configuration is required in the unit to enable DHCP, however your network server will need 
to have it's DHCP service configured for JETSTREAM or LANSTREAM clients and if boot file download 
is required, then the TFTP service should be configured and running. DHCP/BOOTP can also be disabled 
completely by setting the configurable server dhcp parameter to off. See Section 1 .6 for details. 



hgure23 

Our example bootfile 
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The administrative interface to the DHCP sever manager depends on the operating system running on your 
network server and is beyond the scope of this document. Consult your system documentation for details of 
configuring the DHCP service on your server's operating system. 

How to setup BOOTP on page 102 ( How to set-up BOOTP ) describes in detail the BOOTP/DHCP tags ( 
client information items ) that are supported by both BOOTP and DHCP. In addition on Microsoft Windows 
NT, DHCP allows for the configuration of WINS server names. 

If automatic configuration of JETSTREAM/LANSTREAM clients is required, only one service DHCP, 
BOOTP or RARP should be enabled on your network server. 

We strongly recommend that you do not run both the BOOTP and DHCP services on the same network to 
configure JETSTREAM/LANSTREAM clients unless you are very familiar with the potential interactions 
that may result. 



Rebooting 

cli syntax: From the Network Configuration menu select 'Reboot'. You will be asked whether you wish to save your 

reboot configuration changes to non-volatile memory: 

| Save config to FLASH ROM(y/n)] 

The unit will close all connections and then reboot. 

Note As installed from SCO, TCP/IP for SCO XENIX will not allow the unit to reboot across the network. This 
problem can be resolved by a simple modification to the file /etc/inetd.conf. The line that reads: 

tftp dgram udp wait sync /etc/tftpd tftpd 

should be changed to: 

tftp dgram udp wait root /etc/tftpd tftpd 



Resetting to Factory Defaults 

cli syntax: This feature enables you to reset the unit to its default settings. This will clear all configuration data entered 

reset factory by the admin user, and all user accounts, except the default admin user, will be deleted. Select 'Reset' from 
the Network Configuration menu; you will be asked to confirm the reset: 

| Confirm reset to factory defaults (y/n) | 
Type 'y' to reset the unit, 'n' to cancel the command. 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



110 



perfe 



Remote Configuration 



Using JETset 

The easiest way to configure the unit remotely is to connect to the unit from your web browser and use the 
JETset program. 



Telnet 

You can also start a telnet session on the unit's telnet port (23) from another host on the network. No prior 
configuration is necessary to use this feature; two such sessions can be run simultaneously. You will be 
prompted for a login name and password. All functionality will be available except the ability to access 
other hosts. You can use Full Screen mode if you use a terminal type defined on the unit. 

The unit has a security feature which enables you to restrict incoming connections to only those hosts 
defined in the host table. This is described in Section Security. 



SNMP 

Using network management software you can configure the unit remotely from a host or other networked 
computer. See Chapter 6 (SNMP) for more information. 



Security 

Cli syntax: The remote access features of the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit' ) mean that 

set server you access the unit over a network from other hosts or devices. Remote access features are remote 

configuration, reverse and printer line types. To help prevent unauthorised access, the unit includes a 
security feature which enables you to restrict incoming connections to those hosts or devices defined in the 
host table. This feature is enabled/disabled using the 'Security' option on the Network Configuration 
menu. 

The 'security' and 'gui access' parameters are unrelated. 



Off-line Configuration 

A unit can be configured by: 

• Downloading a configuration file from an attached host. See netload on page 165 for information on 
how to load a JETSTREAM/LANSTREAM configuration file. 

• Including a reference to a configuration file (CONFIG_FILE) in the 'Boot' file, referenced by the 
'bootptab' file in the BOOTP/DHCP response, see Overview on page 99 for further details. This 
method allows for the complete configuration of the unit by JETstart and BOOTP/DHCP. 
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The CONFIG_FILE can be created by saving the configuration of an existing unit, see Save Configuration 
to a file on page 1 13, or by using JETstart. 

JETstart is a Java applet specifically designed for producing configuration files for JETSTREAM4000, 8500 
and LANSTREAM2000 units. JETstart will only run in a Java enabled browser. It works by asking context 
sensitive questions about the intended use of your unit, and uses this to create a configuration file which can 
be downloaded into the unit. 

Note JETStart is a service and line configuration program and is not designed to configure the JETSTREAM/ 
LANSTREAM server parameters (such as server IP address, WINS, DNS etc. ), please use BOOTP/DHCP 
or manual configuration for these items. 



Running JETstart 

JETstart has been developed using the Java Development Kit vl . 1 .6 and is therefore only supported by 
Netscape Navigator version 4.05, and later, and Microsoft Internet Explorer version 4.0, and later. 

1 . To open JETstart in your browser, double-click the file Jetstart.htm on the Perle CDROM. 

2. Within the JETstart page, click the JETstart button, at the bottom left of the window, to enter the 
configuration applet. 

3. The first configuration screen allows you to select the type of connection you want for each line: 
Terminal serverTS 

Remote access serverRAS 
PrinterPR 

Serial port emulationSPE 

4. You are then requested screen-by-screen to define the parameters for each connection type. 

5 . The last screen prompts you to save the configuration information as a file, which can then be 
downloaded to one or more Jetstream/Lanstream units. 



Security 

JAVA applets running in browsers are subject to restrictions on file I/O, network connections etc., as 
imposed by the browser's security policy. JETstart requires the ability to write a file to disk, and to display 
a file dialog box, in order to save the generated JETSTREAM/LANSTREAM configuration file to your 
computer. 

5.0.0.4 Netscape 4.05 ( and later ) 

If you are running Netscape Navigator, you will be asked if you want to grant the applet permission to write 
a file. Click the Grant' button. 
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5.0.0.5 Internet Explorer 4 

If you are running Microsoft Internet Explorer under Windows NT or 95, you will need to run the Registry 
Editor, ( for example run regedit.exe ) and add the path of the file wizard.zip ( which is in your installation 
directory ) to the Classpath key in HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM, eg. append 
;C:\jetstart\wizard.jar to Classpath ( if wizard.jar is installed in C:\jetstart ). 

Additionally, adjustments to the security policy should be made from the browser, enabling File Dialog 
creation and file I/O as follows: 

1 . From the 'View' menu, choose 'Internet Options' 

2. Select the 'Security' tab 

3. Select 'Local intranet zone' from the 'Zone' selection box 

4. Click the 'Custom' radio button 

5. Click the 'Settings' button 

6. From the 'Java Permissions' subsection of the 'Java' section, click the 'Custom' radio button 

7. Click the 'Java Custom Settings' button 

8. Choose the 'Edit Permissions' tab 

9. In the section 'Unsigned Content', subsection 'Run Unsigned Content', subsection 'Additional 
Unsigned Permissions', click the Enable radio button for 'Access to all files' and 'Dialogs' 

10. Click 'OK' 

11. Click 'OK' 

12. Click 'Apply' 

13. Click 'OK 



5.0.0.6 HotJava 

If you are running Sun's HotJava, from the Edit menu, choose Preferences then Applet Security. Set Default 
settings for Unsigned Applets to Medium Security. You will now be prompted to permit file I/O when 
saving the configuration. 



Save Configuration to a file 

Cli syntax: You can save the configuration of your JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') to a 

netsave, file on a remote host using TFTP. You can use this configuration file to configure other units. 

netload 

The following information will be saved: 
User Profiles, including passwords 
Port Configuration 
Host Table 
Gateways 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



113 



perfe 



RADIUS details 

Modems 

SNMP 

Information unique to this unit (name, ip address) will not be saved. Make sure you have write permission 
to the file. You can configure tftp in the unit; see Section TFTP configuration. 



Caution Passwords remain with a configuration file. When you download a new configuration file make sure you know 

the passwords in that file. 



Lost Password 

If you are an admin user, and you lose your password, there is no way of logging in without it. This 
restriction is for security reasons. Unless there is another user with admin level privileges (who will have 
the ability to change your password) you will have to reset the JETSTREAM 4000, 8500 or LANSTREAM 
2000 (the 'unit') to its factory default settings. 

cli syntax: If a user forgets his/her password, you can assign a new password; go to the Users Menu and select 'set 

set user password'. 
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Chapter 6 SNMP 



Introduction 

This chapter describes the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') support of SNMP. 



Chapter contents 

This chapter is divided into the following sections: 

• Overview 

• Configuring SNMP support 

Summary of Objects in the JS8500 Private MIB 
JS8500 Private MIB Definitions 

• Network Management 



Overview 

The Simple Network Management Protocol (SNMP) is a protocol for access and control of network 
management information on TCP/IP networks. JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 
'unit') provides an SNMP agent, able to respond to SNMP requests generated by SNMP Managers. The 
unit's implementation of SNMP is compatible with MIB II (RFC 1213) as specified by the SNMP SMI 
document (RFC 11 55). For a full description of SNMP, refer to your SNMP documentation. 

Enterprise-specific parameters are defined by the unit's Private MIB, known as the JS8500 Private MIB 
(the LANSTREAM uses the same MIB). Summary of Objects in the JS8500 Private MIB on page 116 
gives a summary of the objects defined by this MIB. The full version of the MIB is in Table 5. 



Configuring SNMP support 

From the Main Menu select 'network configuration' and then 'snmp'. 



cli syntax: Select 'snmp contact information' to configure the SNMP sysContact and sysLocation objects; an example 

set contact screen is shown below: 

set location 
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add trap Select 'edit traps' to create up to four trap communities; an example screen is shown below: 

delete trap 



internet address 
][ 192. 65.144.190 ] 
H192.65.144.191 ] 
|][ ] 
][ ] 



SNMP Trap messages generated by the unit will only be broadcast to hosts defined by SNMP Trap 
communities. 

Note The unit generates no enterprise-specific traps. 

add community Select 'edit commmunities' to create up to four communities; an example screen is shown below: 
delete community 







-HM—irirnn« 






communi ty 


internet 


address 


permissions 


[public 


] [192 . 65 . 


144.199 ] 


[ none ] 


[net man 


] [ 192 . 65 . 


144.192 ] 


[readonly ] 




m 


] 


[ none 


i 


n 


] 


[ none ] 



The unit's SNMP Agent will only provide information to hosts defined by an SNMP community. 



Summary of Objects in the JS8500 Private MIB 

Table 4 



OBJECT 
NAME 


ADDRESS 


TYPE 


PERMISSIONS 


Serverlnfo 


1.3.6.1.4.1.667.2.1 


Aggregate 


not-accessible 


freeSpace 


1.3.6.1.4.1.667.2.1.1 


Guage 


read-only 


swVersion 


1.3.6.1.4.1.667.2.1.2 


DisplayString 


read-only 


serverName 


1.3.6.1.4.1.667.2.1.3 


DisplayString 


read-only 


domaiName 


1.3.6.1.4.1.667.2.1.4 


DisplayString 


read-only 


portslnfo 


1.3.6.1.4.1.667.2.2 


Aggregate 


not-accessible 


portsNumber 


1.3.6.1.4.1.667.2.2.1 


INTEGER 


read-only 


portslnfoTable 


1.3.6.1.4.1.667.2.2.2 


Aggregate 


not-accessible 


portslnfoEntry 


1.3.6.1.4.1.667.2.2.2.1 


Aggregate 


not-accessible 


portld 


1.3.6.1.4.1.667.2.2.2.1.1 


INTEGER 


read-only 


terminalType 


1.3.6.1.4.1.667.2.2.2.1.2 


INTEGER 


read-write 


baudRate 


1.3.6.1.4.1.667.2.2.2.1.3 


INTEGER 


read-write 


dataBits 


1.3.6.1.4.1.667.2.2.2.1.4 


INTEGER 


read-write 
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OBJECT 


ADDRESS 








TYPE 


PbKMIbblUNb 


NAME 






















parity 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


5 


INTEGER 


read-write 


stopBits 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


6 


INTEGER 


read-write 


pages 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


7 


INTEGER 


read-write 


defaultUser 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


8 


INTEGER 


read-write 


validUser 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


9 


INTEGER 


read-write 


dial 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


10 


INTEGER 


read-write 


flowControl 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


11 


INTEGER 


read-write 


service 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


12 


INTEGER 


read-write 


hostPort 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


13 


INTEGER 


read-write 


local Port 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


14 


INTEGER 


read-write 


host 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


15 


INTEGER 


read-write 


pinDCD 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


16 


INTEGER 


read-only 


pinDTR 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


17 


INTEGER 


read-only 


pinRTS 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


18 


INTEGER 


read-only 


charSends 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


19 


Counter 


read-write 


charReceiveds 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


20 


Counter 


read-write 


phoneNumber 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


21 


DisplayString 


read-only 


modemName 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


22 


DisplayString 


read-only 


idleTimer 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


23 


INTEGER 


read-only 


SessionTimer 


1 


3.6 


1 


4 


1 


667.2.2.2 


1 


24 


INTEGER 


read-only 



JS8500 Private MIB Definitions 

Table 5 



OBJECT TYPE 


SYNTAX 


ACCESS 


STATUS 


DEFINITION 


ServerName 


DisplayString 


Read-write 


Mandatory 


The hostname of the unit 


freeSpace 


Gauge 


Read-only 


Mandatory 


The amount of free 
memory available on the 
unit 


swVersion 


DisplayString 


Read-only 


Mandatory 


The software version 
number 


serverlnfo 


Serverlnfo 


Not accessible 


Mandatory 


A list of objects relating to 
general server 
information 


domainName 


DisplayString 


Read-write 


Mandatory 


The domain name of the 
unit 


portsNumber 


INTEGER 


Read-only 


Mandatory 


The number of ports on 
the unit 


ports InfoTable 


SEQUENCE of 
PortslnfoEntry 


Not accessible 


Mandatory 


The serial ports info table 
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OBJECT TYPE 


SYNTAX 


ACCESS 


STATUS 


DEFINITION 


portslnfoEntry 


PortslnfoEntry 


Not accessible 


Mandatory 


An entry in the 
Portslnfo Table, relating to 
a port 


portID 


INTEGER 


Read-only 


Mandatory 


An index that uniquely 
identifies the port; starts 
from 1 and must be less 
than or equal to 24 


terminalType 


INTEGER { 

wyse60(1) 

vt100(2) 

ansi(3) 

dumb(4) 

term1(5) 

term2(6) 

term3(7) 

} 


Read-write 


Mandatory 


The terminal type of the 
port 


baud Rate 


INTEGER { 

b75(1) 

b300(2) 

b600(3) 

b1200(4) 

D I oUU(u ) 

b2400(6) 

b4800(7) 

b9600(8) 

b19200(9) 

b38400(10) 

b57600(11) 

b115200(12) 

b230400(13) 

} 


Read-write 


Mandatory 


The baud rate of the port 


dataBits 


INTEGER { 

d5(1) 

d62 

d7(3) 

d8(4) 

} 


Read-write 


Mandatory 


The number of databits of 
the port 


parity 


INTEGER { 
none (1) 
odd (2) 
even (3) 
} 


Read-write 


Mandatory 


The parity of the port 


stop Bits 


INTEGER { 
s1 (1) 

s2 (2) 
} 


Read-write 


Mandatory 


The number of stop bits 
of the port 
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OBJECT TYPE 


SYNTAX 


ACCESS 


STATUS 


DEFINITION 


pages 


INTEGER { 
p1 (1) 

P2 (2) 
P3 (3) 
p4 (4) 
p5 (5) 
pb (b) 
P7 (7) 
} 


Read-write 


Mandatory 


The number of pages of 
the port 


defaultUser 


INTEGER 


Read-write 


Mandatory 


The default user of the 
port 


validUser 


INTEGER { 
no(1) 
yes (2) 
} 


Read-write 


Mandatory 


Is there a default user 
user of the port ? 


dial 


INTEGER { 
none (1) 
in (2) 
out (3) 
} 


Read-write 


Mandatory 


The dial status of the port 


flowControl 


INTEGER { 
none (1) 
soft (2) 
hard (3) 
both (4) 
} 


Read-write 


Mandatory 


The flow control being 
used on the port 


service 


INTEGER { 
jslogin(1) 
directraw (2) 
silentraw (3) 
printer (4) 
directtelnet (5) 
silenttelnet (6) 
reversetelnet (7) 
reverseraw (8) 
bidir (9) 
directlogin (1 0) 
silentlogin (11) 
slip (12) 
PPP (13) 
} 


Read-write 


Mandatory 


The type of connection 
being used on the port 


hostPort 


INTEGER 


Read-write 


Mandatory 


The host TCP port of the 
port 


localPort 


INTEGER 


Read-write 


Mandatory 


The local TCP port 
assigned to the port 


host 


INTEGER 


Read-write 


Mandatory 


The host for virtual 
connections 


pinDCD 


INTEGER { 

off (1) 
on (2)} 


Read-only 


Mandatory 


The current status of the 
port's DCD pin. 
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OBJECT TYPE 


SYNTAX 


ACCESS 


STATUS 


DEFINITION 


pinu 1 K 


IN 1 totK { 

off (1) 
on (2)} 


Read-only 


Mandatory 


The current status of the 
port's DTR pin. 


pinRTS 


IN I totK { 

off (1) 
on (2)} 


Read-only 


Mandatory 


The current status of the 
port's RTS pin. 


charSends 


Counter 


Read-write 


Mandatory 


The (resettable) count of 
the number of characters 
sent through the port 


charReceiveds 


Counter 


Read-only 


Mandatory 


The (resettable) count of 
the number of characters 
received by the port 


phoneNumber 


DisplayString 


Read-only 


Mandatory 


The phone number used 
for this port 


modemName 


DisplayString 


Read-only 


Mandatory 


The modem name used 
for this port 


idleTimer 


INTEGER 


Read-only 


Mandatory 


The idle timer for this port 


sessionTimer 


INTEGER 


Read-only 


Mandatory 


The session timer for this 
port 



Network Management 

If you have separate network management software you can interrogate and configure the unit using SNMP. 
For example, using CastleRock Computing's SNMPc program running on a Windows PC/host, 
configuration screens you might see are shown below: 
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Figure 24 

editing the RFC1213 MIB 



Edit MIB Variabl 



Node Name: 192.101.34.217 

MIB Path: |rnet(1).mgmt(2).mib-2(1).interfaces(2).ifTable(2).ifEntry(1).ifPhysAddress(6) II 



Repeat Count: 1 



Variable Name: 
jifPhysAddress 

Variable Value: 
ethernet-csmacd 



MIB: RFC1213-MIB 



u 



r Number MPAddr *~ ObjID 
P HexArr r String 



[-] 

iflndex 

ifDescr 

ifType 

ifMtu 

ifSpeed 



ifPhysAddress 



fAdminStatus 

ifOperStatus 

ifLastChange 



The interface's address at the protocol layer 
immediately "below' the network layer in the 
protocol stack. For interfaces which do not have 



Next 



Get 



Repeat.. 



Top 



UP 



Export.. 



Done 



Help 



Figure 25 

editing the JS8500MIB 



Edit MIB Variabl 



Node Name: 192.101.34.217 
MIB Path: 



Repeat Count: 1 



alix(667).jsB500(2).portslnfo(2).portslnfoTable(2).portslnfoEntry(1).portld(1) 
Variable Name: 



Variable Value: 

(f Number MPAddr robjID 
r HexArr r String 



MIB: JSB500-MIB 



u 



3 



rj 




portld 




terminalType 
baudRate 






dataBits 






parity 
stop Bits 






pages 
defaultUser 






validUser 







|An index that uniquely identifies the port. Starts from 1 and must 
I be less than or equal to 24. 

u 



n 



Next 



Get 



Set 



Repeat.. 



Stop 



Top 



UP 



Export.. 
Done 

Help 
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Figure 26 

Routing information 



■i 1 32 1 01 31 21 7 IpRouteEnlry 



Edit Grph Chrt List Hist Exprt Cust Menu Flip Help 



Dest 


Iflndex 


Metrid 


Metric2 


Metric3 


Metric4 


NextHop 


Type 


Proto 


Age — 


0.0.0.0 


1 


2 


1 


-1 


-1 


192.101.34.222 


indirect 


rip 


2920— 


127.0.0.0 


1 


2 


1 


-1 


-1 


192.101.34.19B 


indirect 


rip 


2921 


158.43.0.0 


1 


2 


-1 


-1 


-1 


192.101.34.222 


indirect 


rip 


2921 


192.65.144.0 


1 


2 


-1 


-1 


-1 


192.101.34.222 


indirect 


rip 


2921 


192.101.34.192 




° 




-1 -l 


192.101.34.217 


direct 


.i 




194.131.147.0 




2 


-1 


-1 1-1 


192.101.34.222 


indirect 


rip 


2922 - 


< 1 

















MEl 
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Chapter 7 Guide for Operators on 
Terminals 



Introduction 

This chapter explains how to use the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') for a 
user on a terminal. It is provided specifically for users, who do not need to be familiar with system 
administration matters. 

Terminal server connections are described in Chapter 1 (Con figuring a Line: Terminal Server- 
Connections) 



Chapter contents 

It is divided into the following sections: 
Logging in 

• Modes of Operation 

• Changing your Password 

• Changing your Terminal Setup 

• Changing your User Environment 
Logging Out 

• Running Sessions 

• Starting a Session 

• Predefining Sessions 

• Starting a Predefined Session 

• Hot-key Commands 

• Resuming a Session 

• Killing a Session 



Logging in 

To be able to log in you must have a login name and password. The system administrator should have set 
these for you. 

• Switch your terminal on and press <return> to call the login prompt. 
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• Enter your login name and press <return>. If your line has been dedicated to you, your login name will 
be displayed in brackets automatically, along with the password prompt. 

• At the password prompt, enter your password and press <return> (your password will not be displayed 
as you type it). 

When you log in, the unit is in Command Line mode. The cli prompt will be followed by a dollar or pound 
sign, for example JS_8500$ (or JS_8500£). The display of a dollar or pound sign will vary according to the 
characters supported by your terminal. 

If you are a restricted user, predefined sessions, set up by the system administrator, may start up 
automatically. If this is the case, go to Section Starting a Predefined Session. 



Logging in via a Modem 

Logging in via modem is the same as if you are directly connected to the unit. An additional feature, 
however, is automatic baud rate detection. 

If your terminal is set to a different baud rate to the line into the unit, pressing <return> for the login 
prompt will display garbled characters or nothing at all. If you send a line break (<break> key) the unit will 
try the next line speed setting. Send breaks until the login prompt appears. At the slower speeds it may take 
some time for a response. 

Note If you do change the line speed by sending breaks, the following message will be displayed at login: 
Warning: Baud Rate Changed to new_speed 

Set the line speed using the 'set line' command, as follows: 

set line n speed new_speed 
e.g. set line 6 speed 115200 



Modes of Operation 

The unit has two modes of operation: Full Screen Mode (FSM) - the text-based menu system - and the 
Command Line Interface (CLI). The CLI is designed for more experienced users. Normal and restricted 
users may prefer to use the menu system. 



Full Screen Mode 

Full Screen mode is a menu system, designed for easy access to commands. To enter Full Screen mode, 
type screen and press <return>. The main menu will be displayed (ensure your terminal type is set 
correctly). For normal and restricted users the main menu contains the following options: 
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For admin users, the complete main menu will be displayed: 





e user [admin 


] JETSTREAM 8500 2.6.0.G 


telnet 1 * 



users 

line configuration 
server conf igurat ion 
radius conf igurat ion 
network configuration 
hardware 

command line mode 



help , arrows : move , return : select 



At the top of the screen is a banner which contains your username, your line number and the current 
version of software. At the foot of the screen is a context-sensitive help line which describes how to move 
around and select menu options. 

To exit Full Screen mode, select 'Command Line Mode' from the main menu. 



Menus 

Move up and down menus using the arrow keys, or by typing the first letter of the option you want to 
select. Select a menu option by pressing <return>; return to the previous menu by pressing <esc>. Type '?' 
to display help information. 



Forms 

Forms contain one or more data fields for you to complete. There are two types of data field: 

• Fields in which you must type a value. These fields start off blank; they have no default value. Some 
fields may require hex values. If in doubt, type the help command (?) when in the field. Use the <del> 
key to backspace. 

• Fields where you select from a list of values. One of these values will be entered as a default. You can 
cycle through the list of values using the <spacebar> key, or list them by typing 'L'(upper or lower 
case). 

Movement between fields is controlled by the following keys: 

<arrows> Use the arrow keys to move between fields in any direction. If a form covers 

more than one page, press the up arrow key on the first line of the form to 
display any previous page. Press the down arrow key on the last line of the 
form to display any next page. 
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<Tab> Moves you through fields on the same line, from left to right. The 

<backspace> key moves you in the opposite direction. 

<PgUp> If the form covers more than one page, you can use the <PgUp> key to display 

any previous page. 

<PgDn> If the form covers more than one page, you can use the <PgDn> key to display 

any next page. 

Note On Ansi and VT100 terminals, the <PgUp> and <PgDn> keys won 't work unless they are programmed as 
A [J and A [K respectively (where A [ = Escape). 

There are two ways to exit a form: 

<return> Use this key if you want to save the changes made to the form. The following 

menu will be displayed: 

Quit Form 

Accept And exit Form 



<esc> Use this key if you haven't made any changes, or if you don't want to save the 

changes you have made. If you haven't made any changes to the form, you will 
be returned to the menu. If you have made changes to the form, the following 
message will be displayed: 

|Changes Will Be Lost, Proceed? (y/n) 
Type 'y' to escape, 'n' to return to the form. 



Command Line Interface (CLI) 

Using the CLI you can enter commands directly rather than through menu options. It is designed for the 
more experienced user. The Command Line has two features that make it extremely easy to use: context- 
sensitive help and command abbreviation. 



Help 

The help key (?) can be pressed at any time to display the options available to you. Look at the following 
example: 

Notice how your original command is always preserved, so that you don't have to type it in again. If you 
type ? at the CLI prompt, all the commands available to your user level would be listed. 

Command Abbreviation 

You can use the shortest unambiguous abbreviation of any command. For example, the command: 
set line 2 termtype wyse60 
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JS_S500# set user . ? 

password 

language 

switch screen switch character 

level securi ty level 

service 

ip_host 

tcp_port 

callback 

phone_number 

idle_t imer 

sess_ timer 

f rained_ip 

f ramed_netmask 

f rained_mtu 

£ rained_coifLpression 

session 

routing 

JS_8E00# set user . | 



could be entered as: 
s e li 2 te w 



Changing your Password 

user levehnormal Select the Sessions menu from the main menu. From here, select 'Set Up User' and then 'Set Password'. 

cli syntax: You will be asked to enter your old (current) password: 

set user 

I Old Pas sword : 



You will then be asked to enter a new password: 

I Enter Pas sword : 



The password can have up to sixteen characters (do not use spaces). Use the <del> key to backspace if 
necessary. You will be asked to repeat the password: 

I Re-enter Pas sword : I 



You will be returned to the Set Up User menu. 



Changing your Terminal Setup 



user levehnormal You are unlikely to need to change your terminal setup, especially while running in Full Screen mode. If 
cli command: you do, remember to make the same changes to your terminal's setup utility, 
set user 

Changes to your terminal type or the number of video pages supported will take effect immediately. Other 
changes will take effect the next time you log in. 

Don't change the number of video pages your terminal supports while you have sessions running. 

Select 'Set Up Terminal' from the Sessions menu. The following form will be displayed. 

These are the default settings. In each field, use the <spacebar> to cycle through the available settings, or 
type 'L' to list them. 
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speed terminal dial flow bits parity stop pages 
I [9600 ][vtl00 ] [none ] [none] [8] [none] [1] [0] 



Changing your User Environment 



Note 



cli syntax: 
set user 



You must have a user privilege level of 'normal' before you can change your user environment (other than 
access by the systems administrator). 

You can change your user environment if 

- your screen switch character clashes with an application you are using in one of your sessions, or 

- if you wish to have the text menus/cli presented in a different language. 

From the main menu select the Sessions menu. From this menu, select the Set Up User menu. Then select 
'Set Environment'. 

The following form will be displayed: 



The Language field defaults to 'English' but can be set to another language using the 'customlang' option. 
Your system administrator will need to download another language into the unit's memory. French, 
German, Italian and Spanish language files are supplied on the supplemental diskette/CD. Switching to 
another language will change your menus and cli only when you save and exit this form. 

The screen switch character must be entered in hex format; see Appendix E (ASCII and HEX conversion 
tables). 



Logging Out 

All users To log off the unit, select 'Logout' from the Sessions menu. You will be unable to log out if you still have 

Command: logout sessions running. 



Running Sessions 

Sessions are started through the menu option 'Sessions' (or through the CLI). You can run multiple 
sessions simultaneously on the same host or on different hosts. You can switch between different sessions 
and between sessions and the unit using hot-key commands. 
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If you are a user with a privilege level of 'normal' you can predefine sessions, even configure them to start 
automatically on login to the unit. If you are a user with a privelege level of 'restricted' you can only start 
sessions predefined for you by the system administrator. 



How many sessions can I have? 

The actual number of sessions available is four minus the number of predefined sessions set up on your 
line. 

If you have four predefined sessions, you will have no free sessions left. You can get around this by 
disabling one of your predefined sessions (in the 'Set Sessions' form (see Section Predefining Sessions), 
set the Type field to 'off'). 



Starting a Session 

Note You can only predefine sessions if you are a user with a privilege level of 'normal' (other than the system 
adm in istrator). 

cli syntax: 1. Select 'Start telnet/rlogin' from the Sessions menu. The following form will be displayed: 
telnet, rlogin 



+H^^^^§E!+ 1 

:-rl '.'l'l-r [ ffaffHq 1 

hostname [ ] 

termtype [ ] I 

username [ ] 

echo [off] 

mapnl [off] 

mode [off] 

intr [7f] 

quit [lc] 

eof [4 ] 

erase [ S ] 

break [Id] 



Complete the fields as follows (using the <del> key to backspace if necessary): 

• Service- this is the connection protocol you want to use: telnet (default) or rlogin. The relative merits 
of these protocols are discussed in Chapter 1 (Configuring a Line: Terminal Server Connections). 

• Hostname - the name or internet address of the machine that you want to access. You must have a 
login account on this machine. If you want to access a machine in your local network which isn't 
defined in the host table, you can only use the hostname if it can be resolved by a name server in your 
network. If you want to access a host outside your local network, it is best to use the internet address. 

• Termtype - the terminal type you enter here will be passed to the host you are trying to log into. The 
termtype must be a name recognised by the host. Your system administrator should be able to tell you 
what to enter. 

• Username (rlogin only) rlogin will pass your unit's username to the target host. If your usemame on 
the target host is different, or if you want to log in as somebody else, enter the required username here. 

The fields after 'Username' are telnet options only. 
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2. Set up the session as required and press <return>. You will be connected to the host. 

3. Using telnet, you will be prompted for your login name then your password; using rlogin, you will be 
prompted for your password only. Once you have logged in, you can use the host as if you were 
directly connected. 

4. You can switch to other sessions, and back to the unit, without logging out - see Section Hot-key 
Commands. 

5. To close a session, log out as normal. You will be returned to the unit exactly where you left off. 



Predefining Sessions 

Note You can only predefine sessions if you are a user with a privilege level of 'normal' (other than the system 
administrator). 



cli syntax: You can predefine up to four sessions. Predefined sessions can be started using the 'Start Predefined 

set user Session' menu option, or they can be set up to start automatically. Select 'Set Up User' from the Sessions 

menu. Select 'Set Sessions' from the Set Up User menu. The Set Sessions form will be displayed: 



session 12 3 4 

[o££ ] [o££ ] [o££ ] 

][pc ][pc ][pc 
][ ][ ][ ] I 

[off] [off] [off] 

[off] [off] [off] 

[off] [off] [off] 

[off] [off] [off] 

[7£] [7£] [7f] 

[lo] [lo] [lo] 

[4 ] [4 ] [4 ] 

[8 ] [8 ] [8 ] 

[Id] [Id] [Id] 




These are the default settings. Complete the fields as follows (using the <del> key to backspace if 
necessary): 

• Service- this is the connection protocol you want to use: telnet or rlogin. The relative merits of these 
protocols are discussed in Chapter 1 (Configuring a Line: Terminal Server Connections). Once this 
field has been set to telnet or rlogin, this session will take up one of your four session slots - whether it 
is active or not. 



• Hostname - this is the name of the machine that you want to access. You can only predefine sessions 
on a host defined in the host table. The first host defined in the host table will be entered as the default. 
To be able to log in to a machine you must have a login account on it. 

• Termrype - the terminal type you enter here will be passed to the host you are trying to log into. The 
termtype must be a name recognised by the host. Your system administrator should be able to tell you 
what to enter. 

• Auto - if this field is set to 'off, the session must be started using the 'Start Predefined Sessions' menu 
option. If the 'Auto' field is set to 'on', the session will start up automatically when the user logs in to 
the unit. If more than one session is set up like this, session 1 will be displayed first. 

The fields after 'Auto' are telnet options only. 
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Starting a Predefined Session 



Note 



cli syntax: 
start 



Users with a privilege level of normal and restricted may predefine sessions (as well as the system 
administrator). 

Use this option to start a predefined session. 

1. Select 'Start Predefined Session' from the Sessions menu. Your predefined sessions will be listed: 




2. Select the session that you want to start. 

3. Press <return>. You will be connected to the host. If you are using telnet, you will be prompted for 
your login name and then your password. If you are using rlogin, you will be prompted for your 
password only. If you use rlogin, and your unit's login name has been entered in the 'rhost' file of the 
target login directory, you will be logged straight in.Once you have logged in, you can use the host as 
if you were directly connected. 

4. You can switch to other sessions, and between sessions and the unit, without logging out (see next 
section). 

5. To close a session, log out as normal. You will be returned to the unit exactly where you left off. 



Hot-key Commands 

All users The commands described in Table 6 can be used to switch between sessions, and to switch between 

sessions and Full Screen/Command Line mode. The command A a means hold down the <control>and <a> 
keys together. This is the screen switch character (or 'hot-key'). 

Note You can change the screen switch character ( A a) if it clashes with a command used by an application you 
are running in one of your sessions. See Section Changing your User Environment. 



Table 6 Hot-Key 
Commands for 
Session Controls 



Function 


Hot- 
key 


Description 


Switch Sessions 


A a n 


To switch from one session to another, press A a 
and then the required session number. For 
example, A a 2 would switch you to session 2. You 
can also use these commands from the unit to 
resume sessions. Pressing A a 0 will return you to 
the unit. 


Display Next 
Session 


A a n 


Use this command to display the next session. 
The current session will remain active. If you use 
this command from the unit, the lowest numbered 
active session will be displayed. 


Display Previous 
Session 


A a p 


Use this command to display the previous 
session. The current session will remain active. If 
you use this command from the unit, the highest 
numbered active session will be displayed. 
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Function 


Hot- 
key 


Description 


Return to the 
unit 


A a m 


To exit a session and return to the unit, use this 
command. You will be returned to where you left 
off. The session will be left running 


Redraw Screen 


A r 


When you switch from a session back to Full 
Screen Mode, the screen may not be redrawn 
correctly. If this happens, use this command to 
redraw it properly. 



The functions 'Display Next/Previous Session' may not work if your terminal does not allow switching 
forward and backward between sessions. 



Video Pages 

You can run four sessions simultaneously. Running the menu system or Command Line counts as a fifth 
session. If your terminal supports five video pages or more, each session can use a different page. The 
result of this is that when you switch between sessions their appearance will be maintained, i.e. they will 
retain their context. 

However, if your terminal supports less than five video pages, sessions may have to share pages. Such 
sessions are termed 'unpaged'. When you switch to an unpaged session, its context will be lost. The 
following message will be displayed: 

[unpaged session n] 

Similarly, when you switch from an unpaged session to a paged session: 

[paged session n] 



Resuming a Session 



cli syntax: 
resume 



Select 'Resume Session' from the Sessions menu. A list of active sessions will be displayed: 



Active Sessions 
telnet socrates 
telnet plato 



Select the session that you want to resume. It will be resumed where you left off. Alternatively, you can use 
the hot-key commands described in Table 6. 



Killing a Session 

cli syntax: This command enables you to kill a session. You cannot log out from the unit while you still have sessions 

kill session running. Select 'Kill Session' from the Sessions menu. A list of your active sessions will be displayed, for 

example: 

Active Sessions 
telnet socrates 
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jtelnet plato | 

Select the session that you want to kill. The following prompt will be displayed: 
| Confirm Kill Session 1 (y/n) 

Type 'y' to kill the session, 'n' to cancel the command. 
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Chapter 8 Examples of SLIP / PPP 
connections 

Introduction 

In Chapter 3 we explained how to configure a JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 
'unit') line for a SLIP or PPP connection. Here we take you through examples. 

The diagrams show a JETSTREAM 8500 unit. The examples in the diagrams apply equally to other 
JETSTREAM models and LANSTREAMs. 

Chapter contents 

This chapter is divided into the following sections: 

• Setting up a Remote User (with PPP) 

• Joining together two networks 
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Setting up a Remote User (with PPP) 

This section provides an example of setting up a remote client to the unit, using PPP. The remote client is a 
single Windows NT4 or 95 computer. Once a successful connection is established to the unit the remote user 
would be able to use network services (e.g. browsing and using the main file server) as if he/she were 
connected to the network locally. 

Figure 27 typical scenario: a single remote user 



RADIUS host WINS host other host 



JETSTREAM 
i 8500 



HOME or 
SMALL OFFICE 
USER 



configure PPP 
tor the line used; 
[see list of parameters 
below] 





standalone 

Win NT4 or 

Win 95 computer 

(there does not have 
to be a network present 
at this end of the link) 



PPP 



The procedure for setting up a remote client depends on the situation, see the follwoing for details: 

• Setting up a remote client on the local network on page 137 

• Setting up a remote client in the unit - on page 137 

• Setting up a remote client in the remote client computer on page 140 

• Setting up a remote client in the main host on the local network on page 141 

• Setting up a remote client in the WINS and/or DNS hosts on the local network on page 141 
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Setting up a remote client on the local network 

1 . check if you have a WINS host machine (Windows Internet Name Server) running on your network. 
A WINS host will allow your remote client to browse; (if you do not have a WINS host, edit the 
LMHOSTS file on the remote client). Note the ip address of the WINS host machine. 

2. check if you have a DNS host machine; note its ip address. 



Setting up a remote client in the unit - 

1. in the line configuration menu select 'modems' and add your modem and its initialisation string. 

2. in the line configuration menu, select 'line settings' and on the line to your remote client configure a 
minimum of: 

line service - set to 'ppp' 

modem name - select your modem name 

dial parameter - set to 'in' 

line speed -set to the highest your modem will 
accept; e.g 57600 

flow (flow control) - set to either 'hardware' or 
'software' ('hardware' is preferred) 

idle timers and session timers - set to values 
of your choice; try 600 and 1800 seconds 
(respectively) 



You can leave the other line settings at default; (see Section Setting Up the Line for more information). 
The form in the text menu could look like this: 



1 


ghr lP ~ 


service [|33^^^B ] 




speed [9600 ] 


term.in.al [ dumb ] 


f low [none ] 


pages [ 4 ] 


bits[8] 


user [ ] 1 


pari ty [ none ] 


host name [pc 


stop[ 1 ] 


host port [23 ] 


security [of f ] 


JS port [23 ] 


dial [none ] 


modem name none 


phone number [ 


] 


idle tirner[ 


] session t imer [ ] 



3. configure PPP for the line you are using to connect to the remote computer. Configure a minimum of: 

local ip address - you allocate this address; an 
example is shown in Figure 28 
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remote ip address - it is an ip address for the 
remote client computer; an example is shown 
in Figure 28 

security - set it to either 'pap' or 'chap'. 

You can leave the other line settings at default; (see Section Configuring PPP for more information). 
The form in the text menu would look like this: 





BiLT=»:]-L 


1 


local ip address[192 . 65 . 148 . 120 


] remote ip address [192.65.148 


86 ] 


subnet mask[ 


accm [ | 




mru [1500] 


secur i ty [ chap ] 




user [ 


password [ 


] 1 


ruser [ 


rpassword [ 


] 


address_comp [on ] 


proto_comp[on ] 




vj_comp[on ] 


magic_neg [of f ] 




ipaddr_neg[of f ] 






conf req . to[ 3 ] 


term req . to [ 3 ] 




1 conf req . re tries [10 ] 


term req. retries [2 ] 




conf nak retries[10 ] 


auth_tmout [ 1 ] 




roaining_callback[of f ] 


challenge_ interval [ 


] 





Figure 28 allocating local and remote IP addresses 



192.65.146.119 - 
(an example) ip address of the 
JETSTREAM as entered 
in 'server configuration' 
(the same as its address 
on its ethernet interface) 



192.65.148.120- 
the local ip address of the 
JETSTREAM as entered 
in 'ppp line' 

(use an address which is 
on the same network or 
sub-network as the 
remote machine) 



local 
network 



JETSTREAM 



networked 
j computer 

) the computer you 
are using to set up 
the connection in 
JETSTREAM 



Remote Client 



PPP 



192.65.148.86 

the ip address of the 
remote client; 
we recommend you set 
this address in the 
JETSTREAM (only) 
- see 'remote ip address' 
in 'ppp line' 



4. (if you are using PAP or CHAP on the PPP line) add or edit a user account for the user who will be at 
the remote end; see Section Add a User Account and/or Section Configure a User Account. 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



138 



perfe 



5. if you have DNS and/or WINS hosts on your network, enter the IP addresses of these machines - go to 
the Network Configuration menu; (see the JETSTREAM 4000, 8500, LANSTREAM 2000, 
Installation Guide, DNS configuration on page 61 and WINS configuration on page 62). The unit will 
transmit these values to the remote client. 

6. 'kill' the line you are using to connect to the remote client computer, then 'restart' it; (in the Line 
Configuration menu 'kill' line; then, in the command line interface use the 'restart' command). 
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Setting up a remote client in the remote client computer 

1 . add and/or configure the modem attached to your computer. Make sure the line settings (baud rate, 
parity, data bits and stop bits) are the same as the line into the unit. The modem speed you choose is 
usually not significant; the two modems will negotiate a speed with each other. 

2. configure PPP. To help you we have listed below the options which you are related to those in the 
unit. For both Windows NT4 and Windows 95 you will find these options under 'Dial-up 
Networking': 



Windows NT4 or 95 
configuration option 

Phonebook entry (NT4) or 
Connection Properties (W95) 

Dial-up Server Type 
Network Protocol 

TCP/IP settings 
TCP/IP settings 



TCP/IP settings 
TCP/IP settings 

- option 'use default gateway on remote 
network' 

Enable software compression 

Log on to network 

Enable PPP LCP extensions 

Scripts 



comments 



enter the telephone number for the line 
connected into your unit; select your modem 
name 

choose 'PPP' 

click on 'TCP/IP'; leave other network 
protocols (e.g. NetBEUI) unchecked 

select 'Server assigned IP address' 
(the unit will send the ip address to this 
computer) 

select 'Server Assigned name server 
addresses' . The unit - acting as the 'server' - 
will send ip addresses of WINS and DNS 
hosts to the client computer (if you have 
entered this information in the unit). 

select 'use IP header compression' 

it is not significant whether you select this 
option 

it is not significant whether you select this 
option 

it is not significant whether you select this 
option 

check this box if you have selected fixed 
callback 'on' in the unit (on the first set up of a 
link, we suggest you leave callback set to 'off') 

select 'none' 
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Windows NT4 or 95 
configuration option 


CUIIIIIIclllb 


Security (NT4) or Advanced Options (W95): 




'accept any authentication 


clicking on this option you can select a 


including clear text' 


security value of 'none' in the unit (under PPP 




line) or you can select security - 'PAP' 




or you can select security 'CHAP' 


'accept only encrypted authentication' or 


if you click on this option, use a security value 


'rem lire* emrrvntpH naccwnrH' 


nf TH AP' (nnl\/\ in thp 1 1 n it (i inHpr PPP linp\ 
ui onnr y\j]\\y] ill inc uniL ^unuci rrr iiiic^ 


(dialog box presented upon connecting to the 


enter the same name and password that 


unit:) 


either the unit or RADIUS is using to 


name: 


authenticate the user 


password: 




domain name: 


do nor enter a domain name (i.e. leave blank) 


X.25 (NT4 only), Network, 


select 'none' 



Note Windows NT and 95 provide a dialling capability; there is no need to use separate dialling software. 



Setting up a remote client in the main host on the local network 

1. If you are not using RIP on this host, add the route to the remote client (which is via the unit). 



Setting up a remote client in the WINS and/or DNS hosts on the local network 

1 . If you are not using RIP on this host(s)) add the route to the remote client (which is via the unit). 

2. Test your connection by pinging the unit from the remote client (or vice versa). If ok, the user at the 
remote end of the link should now be able to connect to your local network. 

3. Once your remote user can connect successfully to the local network you may also wish to use the 
security options of PAP or CHAP on the line (see menu option 'PPP line'). 

4. Once your remote user can connect successfully to the local network you may wish to set up a 
callback service, either: 

- with a number pre-configured for the user (see fixed callback in Section Configure a User Account), 
or 

- with the user providing a number for the unit to call him/her back (see roaming callback in Section 
Configuring PPP). 

In either case if your remote user has a Windows NT computer, he/she must change the selection in the 
'Dial-up Networking' area, as follows: 
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Windows NT4 (not W95) 
configuration option 

Phonebook entry - 

User (or Logon) Preferences - Callback 



comments 



for 'fixed' callback (in the unit) check the radio 
button: 

'Maybe, ask me during dial when the server 
offers' 

for 'roaming' callback (in the unit) check one of 
the following radio buttons, either: 
'Maybe, ask me during dial when the server 
offers' 
or: 

'Yes, call me back at the number below' 
(you must enter a number in the field below 
this option). 
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Joining together two networks 



Figure 29 Joining together two networks 



Server (host) radius Server 



local 
network 



RADIUS Server 



second 
JETSTREAM 
8500 



set 'line service' to 
slip or ppp 

(you do not need 
to configure 
a user account) 



in the first JETSTREAM, 
enter the modem/ 
!SDN TA name and ,,- 
initialisation string; 
a/so set 'dtaf to 'out 
for the port to which 
this device 
is attached. 



first 
JETSTREAM 
8500 




SLIP or PPP 



line service 
.... setting 
same as 
first JETSTREAM 
opposite 



in the second JETSTREAM, 
enter the modem/ 
ISDN TA name and 
initialisation string; 
also set 'dial' to 'in' 
for the port to which 
this device 
is attached. 



Server (host) 



Gateway 

remote 
network 
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Initial Actions 



Figure 30 



1 . Connect two units located on one site by a short length of (RS232) cable, as shown in Figure 30. Do 
not connect modems at this stage. Connect each unit to a separate network. 

Initial connections 



Machine A 



Machine E 



f^"^ J r":;:r : - - : "ll 













first 

network 



JETSTREAM A 



JETSTREAM B 



Server A 



Server B 



short length of coble, 
no modems attached 



second 
network, 
local to the 
first network 



2. Set the ports on both units A and B to either SLIP or PPP (in the menus, use the Line Settings Form; 
see Section Setting Up the Line. In the cli, use the command set slip or ppp line; see Section set ppp 
line or Section set slip line). 

3. Kill the individual line on each unit to make sure the changes have taken effect; (in the menus, go to 
the Line Configuration Menu, then 'Kill Line'. In the cli, use the kill line command; see kill line on 
page 163). 



4. Connect an RS232 cable between the two ports on the units with the following pin outs: 

RXD 6 < — TXD 5 

TXD 5 — > RXD 6 

RTS 8 < — CTS 7 (connection only with hardware flow control) 

CTS 7 — > RTS 8 (connection only with hardware flow control) 

S/GND 4 — S/GND 4 

5 . Set Dial to NONE on both ports. 

6. Set flow control to hardware (SLIP only) or, 

either hardware or software (for PPP; hardware is preferred). 
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Setting IP addresses 

Refer to Figure 3 1 . To set up the SLIP/PPP link between the two units you must setup a transient subnet (a 
separate network on the link between the two units which routes packets between the two networks). 



Figure 31 IP addresses 



first 

192.65.144.0 ne1work 



192.65.144.1 



second 
network 

192.65.145.0 



192.65.145.1 



200.1.1.1 



200.1.1.0 
the transient subnet 



JETSTREAM A 



200.1.1,2 

JETSTREAM B 



To link the two networks (192.65.144.0 and 192.65.145.0) we have created a transient subnet (200.1.1.0) 
and given the interface at unit A the address 200. 1.1.1 and that at unit B to 200. 1 . 1 .2. 

Looking at Figure 3 1 : 

192.65.144.1 is the address of unit A on network 192.65.144.0 

200. 1.1.2 and 200. 1 . 1 . 1 are the respective addresses of the units' interfaces on transient subnet 
200.1.1.0; the transient subnet is the SLIP/PPP link 

192.65.145.1 is the address of unit B on network 192.65.145.0 

7. For each SLIP/PPP interface, set the local and remote IP addresses: 
on unit A, local ip address 200. 1 . 1 . 1 , remote ip address is 200. 1 . 1 .2 
on unit B, local ip address 200. 1 . 1 .2, remote ip address 200. 1.1.1 

8. To complete the setup of the transient subnet, you need to add a gateway to the routing tables in each 
unit. This gateway tells the unit how to direct packets to the remote network; i.e. unit B needs an entry 
to tell it to route all packets destined for the 192.65. 144.0 network via the interface on unit A 
200.1.1.1. 

Use the 'Add a Host' menu item (see Adding a Host on page 55) and enter a host. Then select 'Gateway' 
from the Network Configuration menu. Select 'Add Gateway' and the host table will be displayed; 
select the host. Note that you can define a host only once as a gateway. 

Using the cli, you would make the following entries: 

on unit A: 

add host unitb 200.1.1.2 

add gate unitb net 192.65.145.0 
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which means route packets for network 192.65.145.0 through host (interface) on unit B 200.1.1.2 
and on unit B: 

add host unita 2 0 0.1.1.1 

add gate unita net 192.65.144.0 
which means route packets for network 192.65.144.0 through host (interface) on unit A 200.1.1.1 

9. (only do this step if you are not using RIP on your network) Update the routing table in Server A to 
indicate that the route to machine A is via unit B. Server A in Figure 30 can only send TCP/IP packets 
to those machines it knows about on its network (like Server B). It cannot see machine A or B 
directly, so it has to be told how to get to them. To update the routing table, issue the command, at 
Server A: 

route add machine_A unitb hopcount 

If you want to open the route to all machines (not just machine A) on network 192.65.144.0, issue the 
command: 

route add 192.65.144.0 unitb hopcount 

The syntax of this command varies with operating system (os); check your os manual if you are not sure. 
For example, hopcount is sometimes a number at the end of the command line and sometimes is 
proceeded by -hopcount as in the case of SCO UNIX. 

The hopcount between Server A and Machine A is three, as the IP packets are travelling : NETWORK: 
PPP: NETWORK. 

If the unit B had a PC attached running Chameleon the hopcount would only be 2 as the packets are 
only travelling: NETWORKPPP. 

Once this route is set up the IP packets from Server A will be redirected by unit B to unit A and out onto 
the network. They will be picked up by Machine A and be seen by this machine to have originated from 
a server (host) that is not on its network. 

10. (only do this step if you are not using RIP on your network) The same routing process has to be done 
on Machine A to get the response back to Server A; i.e.: 

route add Server_A unita hopcount 

Likewise, if you want to open the route to all machines (not just server A) on network 192.65.145.0, 
issue the command: 

route add 192.65.145.0 unita hopcount 

This needs to be set up in Machine A to redirect the IP packets back to the Server A or the other network, 
as appropriate. 

11. To test your setup, go to Machine A and ping or telnet Server A (or vice versa). You should have a 
successful connection. If you have problems, refer to Appendix B (Troubleshooting). 

An overview of RIP is given in Appendix D (RADIUS & Networking) of the 8500 Installation Guide. 
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Final actions 

Tip we recommend you have successful communication between the two units, without modems, before starting 

this section. 

12. Connect modems or ISDN TAs to the two units, and connect in turn to the public network. 
Figure 32 Full configuration 



local 
network 



-I 



JETSTREAM A 



JETSTREAM B 



remote 
network 




SLIP or PPP 



13. Cable each unit to its modem with the following pin outs: 



unit 






MODEM or ISDN TA 


RJ45 






DB25 




RXD 


6 


< — 


RXD 


3 


TXD 


5 


— > 


TXD 


2 


RTS 


8 


< — 


CTS 


5 


CTS 


7 


— > 


RTS 


4 


DSR 


2 


— > 


DTR 


20 


S/GND 


4 




S/GND 


7 


DCD 


1 


< — 


DCD 


8 


DTR 


3 


< — 


DSR 


6 



(connection only with hardware flow control) 
(connection only with hardware flow control) 



14. Configure the modems as follows: 

on unit A enter the modem name and initialisation string; set Dial to 'in' 
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on unit B enter the modem name and initialisation string; set Dial to 'out'; enter a 'phone number for 
unit B to dial. 

15. To test communication through the modems and public network, go to Machine A and ping or telnet 
Server A (or vice versa). You should have a successful connection. If you have problems, refer to 
Appendix B (Troubleshooting). 

16. Set the idle and session timers for the line on unit A. Repeat on unit B. 

The two networks should now be able to communicate with each other; the units are acting as routers and 
are effectively transparent to the machines and servers on the respective local and remote networks. 
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Chapter 9 The CLI commands 



Introduction 

This chapter contains a description of each Command Line Interface (CLI) command in the JETSTREAM 
4000, 8500 or LANSTREAM 2000 (the 'unit'). The commands are described in alphabetical order and 
each section includes the user level required to use the command. Most but not all CLI commands have 
menu equivalents. Table 7 plots the menu options against their equivalent CLI commands. 



Table 7 

Menu Option/ 
CLI command 
Equivalents 



MENU 


MENU OPTION 


EQUIVALENT CLI 

\j U IVI IVI M IN U \o ) 


Sessions 


Set Up Terminal. 


set line, show line 




Set Up User Options 


set user, show user 




Kill Session 


kill line 




Logout 


logout 




Resume Session 


resume 




Start Predefined Session 


start 




Start Telnet/Rlogin 


telnet, rlogin 




Become Admin User 


admin 


Users 


Add User 


add user 




Change User 


set user, show user 




Set Sessions 


set user, show user, set telnet, 
show telnet 




Delete User 


delete user 






reset user 




Set Password 


set user, show user 


Line 

Configuration 


Line Port Settings 


set line, show line 




SLIP 


set slip line, show slip line 




PPP 


set ppp line, show ppp line 




Parallel Port Settings 


set parallel, show parallel 




Modems 


add modem, delete modem, show 
modems 




(when quitting the 
'line port settings' form) 


reset line 




(when quitting the 
'parallel port settings' form) 


reset parallel 




Kill line 


kill line 




Kill parallel 


kill parallel 
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MENU 


MENU OPTION 


EQUIVALENT CLI 


COMMAND(S) 








Server 


servername 


set server, show server 


configuration 


internet address 
broadcast address 
subnet mask 

Hnmiain names 
(JUIIIctlll 1 Idl 1 1 c 

ip_host 

authentication 

dhep 

gui access 






banner 






OEM mode 






(the version of software 


version 




running is displayed at the 






top of any menu screen) 






- 


netload, netsave 




(on exit from the Main 


save 




menu when going to the cli) 






- 


debug 


Radius 


Add authentication host 


add radius 


v^onngu ration 








Delete authentication host 


delete radius 




Add accounting host 


add radius 




Delete accounting host 


delete radius 




Change radius settings 


set radius, show radius 




('authentication' - this is a sub- 


set server, show server 




item in the 'server configuration' 






menu) 




Network 


reset 


reset factory 


Configuration 






snmp 


add community, add trap, delete 
community, delete trap, set contact, 
set location, show snmp 




tftp 


set server 




host table (options) 


add host, set host, delete host, 
show hosts 




DNS (options) 


add DNS, delete DNS, show 
server 




WINS (options) 


add WINS, delete WINS, show 
server 




gateway (options) 


add gateway, set gateway, delete 
gateway, show gateways 
show routes 
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MENU 


MENU OPTION 


EQUIVALENT CLI 
COMMAND(S) 




security 
reboot 


set server 
reboot 



add community 

user level: This command enables you to define up to four SNMP communities, 

admin 



Syntax 



add community community_name inetaddress 
none | readonly | readwrite 



Where: 



community jiame is an arbitrary name assigned to the community. 

inetaddress is the internet address that identifies the host(s) in the community. 

none \ readonly | defines the access permissions for the community. 
readwrite 



See also 

add trap, delete community, set contact, set location, show snmp 



add DNS 

user level: This command enables you to define the DNS (Domain Name Service) host or hosts in your network. You 

admin can enter the addresses two DNS hosts in the unit; one will be referred to as the primary host, the other a 

secondary host. The DNS hosts do not have to be the same hosts as entered in your unit's host table. 

On a remote access connection the unit will transmit these addresses to a dial-up Windows NT/95 client. 
Therefore, your remote user does not have to configure DNS parameters in his/her computer. 

For more information on DNS see the Installation Guide, Section . 

Syntax 

add DNS internet_address 
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Note 'DNS' must be entered in upper case. Also: 



internet address is the internet address of your machine providing the DNS; enter the 
address in dot decimal notation. 



Menu equivalent 

Network Configuration - DNS - Add DNS 



See also 

delete DNS, add WINS, show server 



add gateway 

user level: This command enables you to define the gateways in your network. You can add up to twenty gateways 

admin and these must be hosts that you have defined in the host table. 



Syntax 

add gateway hostname type [ inetaddre s s ] 
Where: 



hostname is the name of the host that you want to define as a gateway 

type is the gateway type: default, host or network. The types are: 

• Default - this is a gateway which provides general access 
beyond your local network. 

• Host - this a gateway reserved for accessing a specific host 
external to your local network. 

• Network - this is a gateway reserved for accessing a specific 
network external to your local network. 

inetaddress if you define the type as host or network, you must define the internet 
address of the target host or network. 

Your gateway by default is 'active'; you can change it to 'passive'; see the command set gateway. 
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Menu equivalent 

Network Configuration - Gateway - Add Gateway 

See also 

delete gateway, set gateway 



add host 

user level: 
admin 



This command enables you to add the details of the other hosts in your network. These will be added to the 
host table. You can also add hosts accessed frequently not in your LAN. 



Syntax 



add host hostname inetaddress 
Where: 



hostname is the name of the host (14 characters maximum). 

inetaddress is the internet address of the machine. 



Menu equivalent 

Network Configuration - Host Table - Add Host 



See also 

delete host, set host 



add modem 

user level: Use this command to add modem details to the unit. You will want to add modems which you want the unit 

admin to control. 



Syntax 

add modem name init_string 
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Where: 



name is the name of your modem, e.g. usrobotics28.8, or a name you wish 

to use, e.g. modem4. Do not enter spaces in the name; use the 
underscore _ character; e.g. us_robotics_28.8 

init_string is the initialisation string of the modem; see your modem's 

documentation. 



Menu equivalent 

Line Configuration - Modems - Add Modem or Change Modem 

See also: 

delete modem, show modems 

Note To change modem details in the cli you must 'delete ' the modem, then 'add' it again, with the changed 
details. 

add radius 

user level: Use this command to add RADIUS authentication and accounting hosts to the unit, 

admin 

Syntax 

add radius host type host name secret 

Where: 

host type is either authentication_host or accounting_host 

hostname is the name of the RADIUS host 

secret is the secret (password) shared between the unit and the RADIUS 

host. 

Note You must have the host already entered in the unit's host table; see Section add host. If not you will see a 
message saying that no host is configured. 
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Menu equivalent 

radius configuration - radius settings 

See also: 

delete radius, set radius, set server, show radius 



add trap 

user level: 
admin 



Use this command to define communities which will receive trap messages generated by the unit. Note that 
the unit does not generate any enterprise-specific traps. Up to four trap comunities may be defined. 



Syntax 



add trap tra.p_na.me inetaddress 
Where: 

trapjiame is an arbitrary name assigned to the community. 

inetaddress is the internet address that identifies the host(s) in the community. 

See also 

add community, delete trap, set contact, set location, show snmp 



add user 

user level: 
admin 



This command enables you to add a new user to the system. You will be prompted to enter a password 
(maximum sixteen characters). You must also set the user's level using the set user command. 



Syntax 



add user username 
Where username is the required login name (maximum sixteen characters). 
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Menu equivalent 

Users - Add User 



See also 

delete user, set user, show user 



add WINS 



user level: This command enables you to define the WINS (Windows Internet Naming Service) host or hosts in your 

admin network. You can define a maximum of two hosts. If you wish, it/they can be the same address(es) as a 

machine(s) already entered in the unit host table. 



Syntax 

add WINS inte rnet_addre s s 
Note 'WINS' must be entered in upper case. Also: 

internet address is the internet address of your machine providing the WINS; enter 
the address in dot decimal notation. 



Menu equivalent 

Network Configuration - WINS - Add WINS 



See also 

delete WINS, add DNS, show server 



admin 



user level: If you are a normal user, this command enables you to enter Admin mode. But only if you know the admin 

normal password. This will give you full access to the unit's commands. The unit's prompt will change to a hash or 

pound sign (JS_8500# or JS_8500£) to indicate that you are in admin mode. You must log out and back in 

again to revert to your original mode. 
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Syntax 

admin 

Menu equivalent 

Sessions - Become Admin User 

debug 

level of user: This command will send debug information to the screen. You can be connected to either the Admin port or 
admin a front-mounted port. Use this command only when instructed by your Technical Support. 

Syntax 

debug 

Menu equivalent 

(none available) 

See also 



delete ARP 

This command enables you to delete the ARP table. This is useful for diagnostic and debugging purposes. 
This command is only available from the CLI. 

Syntax 

delete arp 

See also 

show ARP 
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delete community 

user level: This command enables you to delete SNMP communities defined using the add community command, 

admin 

Syntax 

delete community 1 | 2 | 3 | 4 

Communities are numbered according to the order they are created in. You can list them using the show 
snmp command. 

See also 

add community, delete trap, show snmp 

delete DNS 

user level: This command enables you to delete the DNS (Domain Name Service) host or hosts in your network, 

admin 

Syntax 

delete DNS internet_address 
Note 'DNS' must be entered in upper case. Also: 

internet address is the internet address in dot decimal notation. If you cannot 

remember the address type a space and then a question mark after 
DNS; e.g. del DNS ? 

The unit will list the ip addresses of DNS machines entered in its 
DNS table. Type the ip address. 

Menu equivalent 

Network Configuration - DNS - delete DNS 

See also 

add DNS, delete WINS, show server 
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delete gateway 



user level: 
admin 



This command enables you to delete a gateway. The host will not be deleted from the host table. 



Syntax 



delete gateway hostname 

Menu equivalent 

Network Configuration - Gateways 

See also 

add gateway, set gateway, show gateways 



delete host 

user level: This command enables you to delete a host from the host table. If the host is referenced by any predefined 

admin telnet or rlogin session, or is defined as a gateway, DNS or WINS host, the message <in use> will be 

displayed and it will not be deleted. 



Syntax 

delete host hostname 

Menu equivalent 

Network Configuration - Host Table 



See also 

add host, set host 
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delete modem 

user level: Use this command to delete modem details from the unit, 

admin 

Syntax 

delete modem modem name 



If you cannot remember the name of the modem, key the first few significant letters or type ? 



Menu equivalent 

Line Configuration menu - modems - delete modem 



See also: 

add modem, show modems 

Note To change modem details in the cli you must 'delete' the modem, then 'add' it again, with the changed 
details. 



delete radius 

user level: Use this command to delete RADIUS authentication and accounting hosts from the unit, 

admin 

Syntax 

delete radius host type host name 

Where: 

host type is either authentication_host or accounting_host 

hostname is the name of the RADIUS host 



Menu equivalent 

radius configuration - radius settings 
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See also: 

add radius, show radius 

delete trap 

user level: This command enables you to delete SNMP trap communities defined using the add trap command, 

admin 

Syntax 

delete trap 1 | 2 | 3 | 4 

Communities are numbered according to the order they are created in. You can list them using the show 
snmp command. 

See also 

add trap, delete community, show snmp. 

delete user 

user level: This command enables you to delete a user. You cannot delete the following: the default admin user, users 

admin that are logged in or users whose line is dedicated to them. 

Syntax 

delete user username 

Menu equivalent 

Users - delete user 

See also 

add user, set user, show user 
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delete WINS 

user level: This command enables you to delete the WINS (Windows Internet Naming Service) host or hosts in your 

admin network. 



Syntax 

delete WINS internet_address 
Note 'WINS' must be entered in upper case. Also: 

internet address is the internet address in dot decimal notation. If you cannot 

remember the address type a space and then a question mark after 
WINS; e.g. del WINS ? 

The unit will list the ip addresses of WINS machines entered in its 
WINS table. Type the ip address. 



Menu equivalent 

Network Configuration - WINS - delete WINS 



See also 

add WINS, delete DNS, show server 



heap 

user level: This command tells you how much free memory currently exists and the largest available fragment, 

admin 



Syntax 

he ap 

help 

all users The help command displays a brief description of how to use the Command Line: 

Type ? at any time to list possible options 
(e.g. set user?) 
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Syntax 

help 

kill line 

user level: This command can be used to kill the processes on a serial line, 

admin 

Syntax 

kill line n 
Where n is the line that you want to kill. 

Menu equivalent 

Line Configuration - Kill Line 

See also 

kill session, reset line, restart, kill parallel 

kill parallel 

user level: This command can be used to kill the processes on a parallel line, 

admin 

Syntax 

kill parallel n 
Where n is the line that you want to kill. 

Menu equivalent 

Line Configuration - Kill Line 



See also 

kill session, reset parallel, restart, kill line 
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kill session 



all users 



This command enables you to kill a session. 



Syntax 



kill session n 

Where n is the session that you want to kill. To see how your sessions are numbered, use the show sessions 
command. 

Menu equivalent 

Sessions - Kill Session 

See also 

kill line, logout, resume, show sessions 



logout 



user levels: 
all users 



This command logs you off the unit. You won't be allowed to log out if you still have sessions running. 



Syntax 



logout 



Menu equivalent 



Sessions - Logout 



See also 



kill line, kill session 
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netload 

user level: This command allows you to download a file over a network from a host using TFTP. The file can be one 

admin of several types; e.g. a configuration file of another unit. The list of file types is shown below. 



Syntax 



netload [nowrite] filetype hostname filename 
where you replace the word 'filetype' with one of the following words: 



customlang a language file either supplied or translated; 

see Section Language of your choice 

configuration a configuration file of a unit 

terml the first of your extra terminal definition files 

term2 the second of your extra terminal definition files 

term3 the third of your extra terminal definition files 

software a new version of a unit's software 



and where: 



hostname is one from the list of hosts defined in the unit's 

host table. Type ? to show the host table entries. 
Select a host by typing its name, e.g. aristotle. 

filename must include the path to the file e.g. /etc/ 

jetstream/config/... The path/filename must start 
with the 'forward slash' / character; do not specify 
a drive letter. 

For terminal definition files, the unit will refer to 
your filename (after downloading) as either 
'termT 'term2' or 'term3'. 

nowrite is an optional parameter which allows you to put 

the downloaded file into RAM without a write to 
FLASH memory. You must type the word 'nowrite' 
immediately after 'netload' (separated by a 
space). Subsequently you can save the file to 
FLASH by re-using the netload command without 
the 'nowrite' option. 

During and/or after download you will see status messages at the command line, e.g. 
TFTP: transfer succeeded 
Note you can configure TFTP in the unit; see the command set server. 
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The downloaded files will take effect as follows: 



customlang 
configuration 



terml , term2 and 
term 3 



software 



see Section Language of your choice 

immediately after successful download. When you 
continue to use the cli or menus, you will be using 
the new configuration 

see Section Downloading Terminal Definitions 
when you reboot the unit. See Section reboot 



If you have used the 'nowrite' option and you now wish to discard this file in RAM and revert to the original 
file in FLASH, you must reboot the unit. Use the cli command reboot. 



Menu equivalent 

(none available) 



See also 

netsave, reboot, set server 



netsave 

user level: This command enables you to save two types of information to a file on a remote host: the configuration of 

admin your unit and crash details. 

Configuration information 

The following information will be saved: 

User Profiles, including passwords 

Port Configuration 

Host Table 

Gateways 

RADIUS details 

Modems 

SNMP 

Information unique to this unit (name, ip address) will not be saved. Make sure you have write permission 
to the file.You can use this configuration file to configure other units. The configuration can subsequently 
be reloaded using the netload command. 
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Crash information 

When the unit has rebooted after a crash you can save crash information to a file on a remote host. This 
information will be diagnostic data for use by Technical Support personnel. 



Syntax: 

netsave type hostname filename 
where you replace the word 'type' with one of the following words: 



configuration the configuration of your unit 

crash information associated with the last crash of the unit 



and where 



hostname 



filename 



is one from the list of hosts defined in the unit host 
table. Type ? to show the host table entries. 
Select a host by typing its name, e.g. aristotle. 

must include the path to the file e.g. /etc/ 
jetstream/config/... 



Menu Equivalent: 

(not available) 



See Also: 

netload, save 



ping 

all users If you are having trouble accessing a host, try the ping command. This tries to elicit a response from the 

specified host. If successful, a report similar to the following will be generated: 
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# ping socrates 

PING socrates (19 2.101.34.1): 100 data bytes 

108 bytes from 19 2.101.34.1: icmp.seq=0. time=15. ms 

108 bytes from 19 2.101.34.1: icmp.seq=l. time=12. ms 

- - - socrates PING statistics - - - 

10 packets transmitted, 10 packets received, 0% packet loss 
round-trip (ms) min/avg/max = 12/12/15 



You can interrupt the process by pressing any key. 

If the hostname cannot be resolved, the following message will be displayed: 



|Ping: hostname : Host not found | 
If the host has been resolved, but the network it is on is unreachable, the following output will be 
generated: 



ping hos tname/ i net addre s s 



100 data bytes 



ping: t_rcvudata: ENETUNREACH - Network is 
unr e achabl e 



If the host has been resolved, but it isn't answering, the following will be displayed: 



ping hos tname/ ine t addre s s 



100 data bytes 



10 packets transmitted, 0 packets received, 
100% packet loss. 



Syntax 



ping hos tname / ine t addre s s [packe t_s i ze ] [packe t s_sent ] 
Where: 



hostname/ is the hostname or internet address of the machine that you 
inetaddress want to ping. 

packet jsize is the size of packet sent (default = 100 bytes). 

packets _sent is the number of packets sent (default = 10). 



reboot 



user level: 
admin 



This command will reboot the unit. You will be asked to confirm the reboot with the following prompt: 

save config to flash ROM y/n 

If you press 'y' the unit will save your configuration, close all connections and then reboot. If you press 'n' 
the unit will prompt you: 
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confirm reboot unit y/n 
Press 'y' to reboot, 'n' to cancel. 

For more information on how the unit reboots, see BOOTP, Section Overview. 
Rebooting does not reset the unit to factory default settings. 



Syntax 

reboot 



Menu equivalent 

Network Configuration - Reboot 



See also 

show server 



reset factory 

user level: This command will reset the unit to its default values. The unit will save the factory default settings to 

admin FLASH memory; this saving will take a few seconds. After this period you will be logged out and 

presented with a new login prompt. 



Syntax 

reset factory 



Menu equivalent 

Network Configuration - Reset 

See also 

reboot 
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reset line 

user level: 
admin 



This command will reset the specified serial line(s) to the default line configuration. 

Syntax 

reset line ./n/* 
Where: 



specifies the current line. 

is a specific serial line number. 

specifies all serial lines. 



Menu equivalent 

Line Configuration - Line Settings - Quit form 

See also 

kill line, restart, show line, set line, reset parallel 



reset parallel 



user level: If you have parallel port(s) fitted to your unit, this command will reset the specified parallel line(s) to the 

admin default line configuration. 



Syntax 



reset parallel n / * 
Where: 



is a specific parallel line number, 
specifies all parallel lines. 
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Menu equivalent 

Line Configuration - Parallel Port Settings - Quit form 

See also 

kill parallel, restart, show parallel, set parallel 



reset user 

user level: This command will reset the specified user(s) to the default user settings. This sets the user level to 

admin 'normal' and the screen switch character to '1*. Any predefined sessions are switched off. The default 

admin user will not be reset. 



Syntax 



reset user . / * / username 
Where: 



specifies the current user. 
username is the name of a specific user. 

* specifies all users. 



See also 

reboot 
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restart 

user level: When there is insufficient free memory to start a login or virtual circuit on a line, that line will appear dead 

admin and you will be unable to restart it. You must wait until sufficient memory is available and then restart all 

such lines using this command. You can enter the command on any active serial line. The execution of the 

command will affect halted processes on all lines, both serial and parallel. 



Syntax 



restart 

Menu equivalent 

(none available) 

See also 

heap, kill line, kill parallel 



resume 

user level: The resume command enables you to resume any session that you have left running. You will be returned 

all users to your last position in a session. 



Syntax 



resume n 
Where n is the session you want to resume. 

Menu equivalent 

Sessions - Resume Session 



See also 

kill session, start 
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rlogin 

user level: This command will establish a connection with a host using the rlogin protocol. Rlogin passes your login 

admin, normal name to the host, so you are prompted for your password only. If your unit's login name exists in the 'rhost' 
file of the target login directory, you won't be prompted for a password. You will be logged straight in. 



Syntax 

rlogin hostname/ inetaddress [termtype termtype] [user 
usernaite] 

Where: 



hostname/ 
inetaddress 

termtype 



username 



is the hostname or internet address of the machine you want 
to log into. 

is your terminal type. By default a dumb terminal type is passed to 
the host. When connecting to a UNIX host, you must define the 
termtype in accordance with its UNIX TERM variable. 

is your login name on the target host if different to your unit's login. 
You can also use this argument to log in as someone else. 



Menu equivalent 

Sessions - Start telnet/rlogin 



See also 

kill session, resume, show line, start, telnet 



save 

user level: This command enables you to save the configuration information of your unit to FLASH 

admin (permanent, non-volatile) memory. Note that the save command does not apply to language files 

or any other files downloaded into RAM using the netload command. The writing to FLASH will 
take a few seconds and during this time the unit will not respond to user input. 



WARNING do not turn the power on/off while the unit Is writing to FLASH memory. 



Syntax: 

save 
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See also 

netload, netsave 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



174 



perfe 



screen 

all users This command will change you from Command Line mode to Full Screen mode (on supported terminal 

types only). 



Syntax 

screen 



set contact 

user level: This command enables you to configure the SNMP sysContact object, 

admin 

Syntax 

set contact contact_name 

Where contact _name is a string representing your contact name; it cannot contain spaces (e.g. john.smith, 
john_smith or johnsmith) 



See also 

set location, show snmp 
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set date 



user level: This command enables you to set the date in the unit. The date is used by the real-time clock. For more 

admin information on the real-time clock see JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, 

Setting Date and Time on page 55. 



Syntax 



set date dd/mm/yyyy 
for example; set date 05/12/2000 



Menu equivalent 



Main Menu - hardware 



See also 

set time 
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set ethernet interface RJ45 

user level: This command enables you to select the RJ45 10/100Base-T interface, 

admin 

Syntax 

set ethernet interface RJ45 



See also 

set ethernet interface AUI, show hardware 

set ethernet interface AUI 

user level: This command enables you to select the AUI interface, 

admin 

Syntax 

set ethernet interface AUI 



See also 

set ethernet interface RJ45, show hardware 

set ethernet speed 

user level: This command enables you to select the speed of the Ethernet RJ45 interface, 

admin 

Syntax 

set ethernet speed speed-value 
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Where: 

speed-value can be set to one of the following: 

Auto: auto-sense the speed of the ethernet interface (default) 
10M: set speed to 10 Mbps 
100M: set speed to 100 Mbps 

See also 

set ethernet interface RJ45, show hardware 
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set gateway 

user level: This command enables you to redefine a gateway, 

admin 

Syntax 

set gateway hostname type [ inet addre s s ] [status] 
Where: 



hostname is the name of the gateway. 

type is one of 'default', 'host' or 'network'. 

inetaddress is the internet address of the target host or network. 

status is one of: 'active' or 'passive'. 

For definitions of active and passive see the Installation Guide 

Gateways on page 63. 



Menu equivalent 

Network Configuration - Gateway - Change Gateway 



See also 

add gateway, delete gateway, show gateways 

set host 

user level: Use this command if you need to change the internet address of one of the hosts in your host table, 

admin 

Syntax 

set host hostname inetaddress 



Menu equivalent 

Network Configuration - Host Table - Change Host 
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See also 

add host, delete host, show hosts 
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set line 



user levels: 
admin, normal 



Use this command to configure lines on the front-mounted RJ45 ports only. The command cannot set: 

the Admin Port line configuration; this is fixed - see the Installation Guide, The Admin Port on page 3 7. 

the parallel port line configuration; see the command set parallel. 

An admin user can change the setup of any line; a normal user can change their own line only. On login 
connections, changes to the terminal type or number of video pages will take effect immediately. Other 
changes will take effect when a user next logs in on the line. 



Syntax 

set line 1 ine_number 
[speed speed] 
[parity parity] 
[stop stop-bits] 
[data data-bits] 
[flow f low- control] 
[pages pages] 
[termtype term-type] 
[dial dial-status] 
[user us e r - name] 
[nouser ] 

[service 1 ine_service] . . . . followed by (optionally) 

[raw/telnet] [hostname] [j s_port] [host_port] 
[phone_number phone -number] 
[modem_name modem- name] 
[idle_timer i-timer value] 
[ s e s s i on_t imer s-timer value] 
[routing routing] 
[security security] 

Where: 

linejiumber may also be specified as '*' for all lines or '.' for the line currently 
being used. 

speed, parity, stop-bits, data-bits, flow control are standard line settings 

pages (for 'jslogin' line service) is the number of video pages the terminal 

supports. 

term-type is the type of terminal attached to this line; e.g. ansi. Note this value 

will be ignored if you have set a termtype value using the command 
telnet. 
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dial-status use when a modem is attached to a port; set to 'in' or 'out' (default 

none). Note that 'dial-status' is unrelated to the User 'callback' 
parameter. 

user-name (for js login line service) can be used to dedicate the line to a 

specific user. Only this user will be able to log in on this line and they 
won't need to enter their login name - just their password. 

nouser (for js login line service) nullifies the user argument; it enables 

any user to log in on this line. 

line-service select from one of: jslogin, direct, silent, reverse, printer, bidir, slip or 
ppp. 

for remote access connections, see Section Setting Up the Line, sub- 
section Service. 

when you select 'direct', 'silent' or 'reverse', you must specify 
whether the line service is 'raw' or 'telnet'; e.g. silent telnet. 

when you select 'direct', 'silent' or 'bidir', you must enter the target 
host name; e.g. sophocles. 

when you select 'direct raw', 'silent raw' or 'bidir', you must specify 
the TCP port assigned on the target host to listen for the incoming 
connection. 

when you select 'reverse raw' or 'bidir', you must specify the TCP 
port assigned to the unit's port (that is the JETSTREAM 4000, 8500 
or LANSTREAM 2000 TCP port number). TCP/IP hosts will use 
this TCP port to establish a connection with the unit. 



phone-number a number which the unit will dial on that line, when 'dial' is set to 

'out'. Enter the number without spaces. To change the phone number 
overwrite the previous entry. 

modem-name is the name of the attached modem; e.g. usrobotics28.8, or a name 
you wish to use, e.g. modem 1. Do not enter spaces in the name; use 
the underscore _ character; e.g. us_robotics_28.8. You can enter a 
total of nineteen alphanumeric characters (including spaces). 

i-timer value enter a period in seconds for which the idle timer will run. Use this 
timer to close a connection because of inactivity. When the idle timer 
expires, if there has been no exchange of data, the unit will end the 
connection. The default value is 0 (zero), meaning that the idle timer 
will not expire (the connection is open permanently). 

This idle timer will be overriden by the idle timer which you can 
configure for a user; i.e. the user idle timer takes precedence. 
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enter a period in seconds for which the session timer will run. Use 
this timer to forcibly close the session (connection). When the 
session timer expires the unit will end the connection. The default 
value is 0 (zero), meaning that the session timer will not expire (the 
session is open permanently, or until you kill the line or you/the user 
log(s) out). 

This session timer will be overriden by the session timer which you 
can configure for a user; i.e. the user session timer takes precedence. 

determines whether RIP packets are sent over SLIP/PPP connections. 
Can be set to None (off), send, listen or send & listen. 

This may be set to on or off to enable login/password authentication 
on reverse telnet and other reverse type connections. The unit's 
stored user database is always used for this authentication. The 
default setting is off. 

Any number or combination of the arguments can be used. 
Examples: 

set line 6 service silent telnet plato 

set line 3 service reverse raw 1000 

set line 9 speed 38400 modem in service bidir 
homer 10 0 0 9 0 0 

You can set all lines to the same parameters by using the * asterisk character, e.g. 

set line * speed 38400 dial in 

will set all lines to this speed and dial values. 

Menu equivalent 

Line Configuration - Line Settings 

See also 

show line, add modem, set parallel 

set location 

user level: This command enables you to configure the SNMP sysLocation object, 

admin 



perfe 



s-timer value 



Routing 
security 
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Syntax 



set location location 



See also 



set contact, show snmp 



set parallel 



user levels: 
admin 



If parallel port(s) are fitted to your unit use this command to configure lines on the parallel port(s). 



Syntax 



set parallel 
1 ine_number 

[service 1 ine_service] . . . . followed by (optionally) 

[raw] [hostname] [ j s_port ] [host_port] 



line jiumber may be specified as '*' for all parallel lines or '.' for the line 



Any number or combination of the arguments can be used. 
Examples: 

set par 1 service printer 

Menu equivalent 

Line Configuration - Parallel Port Settings 

See also 

show parallel, reset parallel, kill parallel 



Where: 



currently being used. 



line-service 



select from one of: printer. 
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set ppp line 



user level: 
admin 



Use this command to configure PPP on a line. 



syntax 



set ppp line line_number parameter 
where: Hne_number may also be specified as * for all lines, or . for the current in-use line, 
parameters are any from the list below: 



parameter syntax 



lipaddr 
ripaddr 
subnet 
accm 

mru 

security 
user 

password 

ruser 

rpassword 

ac^comp 

proto_comp 

vj_comp 

magic_neg 

ipaddrjieg 

crjmout 

trjmout 

cr_retry 

tr_retry 

nak_retry 



parameter name 



local ip address 

remote ip address 

subnet mask 

asynchronous character 
control map 

maximum receive unit 

security 

user 

password 
remote user 
remote password 
address/control compression 
protocol compression 
VJ compression 
magic number negotiation 
ip address negotiation 
'configure request' timeout 
'terminate request' timeout 
'configure request' retries 
'terminate request' retries 
'configure nak' retries 
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parameter syntax 


parameter name 


authjmout 


authentication timeout 







The meanings and values of these parameters are explained in the Configuration Guide Section Configuring 
PPP. 

You can include multiple parameters in one line of syntax. 

Menu equivalent 

Line Configuration - Line Settings 

See also 

show ppp line 

set radius 

user level: Use this command to set RADIUS settings of the unit: 

admin 

Syntax 

set radius <parameter> 

The parameters are detailed inJETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, Section 
RADIUS con figuration. Type a question mark ? at the command line prompt to see a list of the parameters. 
You can enter multiple parameters on one line. 

Menu equivalent 

radius configuration- radius settings 

See also 

add radius, show radius, set server 
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set server 

user level: Use this command to configure the home setup of the unit, 

admin 

Syntax 

set server 

[name server - name] 
[internet inet - addre 
[subnet suinet] 
[broadcast broadcast 
[domain domain] 
[ip_host user - iphost 
[authentication auth 
[tftp retry retry-va 
[tftp timeout timeou 
[security security- s 
[gui_access gui-stat 
[banner banner - s t a t u 
[OEM-mode mode-flags 



ss] 

] 

] 

-method] 
lue] 

t - va lue] 

t a t us] 

us ] 

s] 

] 



server-name 



inet-address 



subnet 



broadcast 



domain 



user-iphost 



set or change the name of the unit. The name can be a maximum of 
14 characters. After this action, you must reboot the unit; use the 
command reboot. 

set or change the internet address of the unit. After this action, you 
must reboot the unit afterwards; use the command 'reboot'. 

set or change the subnet mask of your network. For information on 
the subnet mask parameter, see Section Initial Configuration. 

set or change your broadcast address. Once you have entered an IP 
address and subnet mask, the broadcast address will default to the IP 
address with the host part(s) set to 255. After this action, you must 
reboot the unit; use the command reboot. 

set or change your domain name. After this action, you must reboot 
the unit; use the command reboot. 

the default ip host for all users who login to the unit. Enter an internet 
address in dot decimal notation; e.g. 192.101.34.202. The IP address 
entered here does not affect any line configuration. 
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auth-method set the authentication method for users, when they login to the unit; 

the method is 'local', 'both' or 'radius'. For an explanation of these 
types, see JETSTREAM 4000, 8500, LANSTREAM 2000, 
Installation Guide, Section Initial Configuration. 

retry-value is the number of times the unit will attempt to transfer (using tftp) a 
file to/from a host. Enter a value between 0 and 255. The default value 
is 5 . A value of 0 means that the unit will not attempt a retry should 
tftp fail. 

timeout-value is the time in seconds the unit will wait for successful transmit or 
receipt of tftp packets before retrying a tftp transfer. Enter a value 
between 1 and 255. The default value is 3. 

security-status By enabling security, you restrict certain types of incoming 

connections (reverse and printer line types and remote configuration) 
to the hosts or devices defined in the host table. The values are 'on' 
and 'off; the default is 'off' (security disabled). 

gui-status use this parameter to control access to the unit's graphical 

configuration programme, JETset . 

The default is 'off. When set to 'on' the user with username 'admin' 
can access the JETset program from a Web browser, using the unit's 
internet address. Entry to the programme is controlled by password. 

If you are not using JETset to configure the unit, we suggest you set 
this parameter to 'off; access will be denied any person trying to 
connect to the unit. 

banner-status this parameter concerns the banner information (product name/ 

software version). This banner information is presented to a user with 
a login prompt. For security reasons you may wish to turn off the 
display of this information. The choices are ON or OFF. The default 
is OFF. 

This parameter does not affect logins using Telnet/Rlogin or the 
Admin Port; in both these cases the banner information shall always 
be displayed. 
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OEM-mode A 16-bit store allowing 16 independent items of OEM functionality 
to be enabled or disabled. It is set as a hexadecimal number in the 
range 0000 to FFFF. 

Currently 2 options are available; 

OEM Menu Mode - (OEM_mode 0001), this replaces the standard 
"login" prompt with the text from the "OEM1 " string in the custom 
language. 

The OEM1 string can be replaced by a formatted character string of 
up to 300 characters. When OEM_mode has bit 0001 set and the 
custom language is loaded the contents of the OEM 1 string are 
displayed as the login prompt. 

This facility is useful for creating a simple user definable single level 
menu system. 

See Section Language support and Section netload for information 
on configuration of the custom language. 

Password Disable Mode - (OEM_mode 0002), password entry 
(prompt) is bypassed for users with no password set. 

Setting this bit will cause the password prompt to be bypassed when 
no password is set for the user. It can be used in conjunction with 
OEM_mode 0001 to enable a simple menu system. 



Any combination of the arguments can be used. Examples: 



set server name stimpy 

set server name stimpy tftp retry 2 

set server internet 192.101.34.202 broadcast 255.255.255.254 ip_host 
72.96.0.2 



Menu equivalents 

server configuration 
network configuration 



See also 

show server, set date, set time, show hardware, reset factory 
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set slip line 



user level: 
admin 



Use this command to configure SLIP on a line. 

syntax 

set slip line line_number parameter 

where: 

line_number may also be specified as * for all lines, or . for the current in-use line, 
parameters are any from the list below: 



parameter syntax 



parameter name 



lipaddr 

ripaddr 

subnet 

mtu 

priority 

transmiLparameters 

icmp_suppress 

vj_comp 



local ip address 
remote ip address 
subnet mask 

maximum transmission unit 
interactive priority 
transmit parameters 
suppress icmp 
VJ compression 



The meanings and values of these parameters are explained in Section Configuring SLIP. 

You can include multiple parameters in one line of syntax (up to a maximum of 100 characters). 

Menu equivalent 

Line Configuration - Line Settings 

See also 

show slip line 



set telnet 

user levels: 
admin 



Use this command to set telnet parameters on a line. It is available for line service types of: 
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Direct telnet 
Silent telnet 

This command also sets default telnet values when you telnet to a host using the cli command telnet. 



Syntax 

set telnet 

[line 1 ine_number] 

[termtype terminal - type] 

[echo value] 

[mapnl value] 

[mode value] 

[ i nt r val ue J 

[ qu i t val ue J 

[ eof val uej 

[erase val ue J 

[break valuej 

Where: 



linejiumber is the serial line number connected; for example 3 

terminal type is your terminal type; for example wyse60. Note this value will be 
ignored if you have set a termtype value using the command 
telnet. 

echo on or off 

mapnl on or off 

mode on or off 

intr <hexadecimal> 

quit <hexadecimal> 

eof <hexadecimal> 

erase <hexadecimal> 

break <hexadecimal> 



Note: 

echo, mapnl, mode, intr, quit, eof, erase and break are telnet options. 



Menu equivalent 

not available in the text menus 
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See also 

show telnet, telnet 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



192 



perfe 



set time 

user level: This command enables you to set the time in the unit. The time is used by the real-time clock. For more 

admin information on the real-time clock see JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, 

Setting Date and Time on page 55. 



Syntax 

set time hh : mm [:ss] 
for example; set time 1 1 :23 

Optionally you can specify the number of seconds; e.g. set time 1 1 :23.30 



Menu equivalent 

Main Menu - hardware 



See also 

set date, show time 



set user 

user levels: This command enables you to modify a user's setup, including predefined sessions. An admin user can 
admin, normal change any user's setup. A normal user can only change certain elements of their own setup, e.g. password 
and language. 



Syntax 

set user username/. 

[language language -name] 
[pas sword ] 
[level user-level] 
[switch swi tch_character] 
[service user - service] 
[ip-host iphost - address] 
[tcp_port t-port number] 
[callback callback- flag] 
[phone_number phone - number ] 
[idle_timer i -timer value] 
[sess timer s-timer value] 
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[framed_ip f-ip address] 
[ f ramed_netmask f-netma.sk] 
[framed_mtu f-mtu value] 

[ f r amed_c ompr e s s i on f - compression value] 
[ s e s s ion n J 



Where: 



switch- 
character 



user-service 



iphost-address 



language-name is either english or customlang (a language of your choice, either 
supplied or translated; see Section Language of your choice). 

password if you include this argument you will prompted to enter a new 

password. 

user-level is 'admin', 'normal', 'restricted'or 'menuing'. For an explanation of 

these terms see Section User Levels. 

is the hex value of the 'hot-key' used for switching sessions. 
The default is 1 ( A a). See the ascii code chart in Appendix E (ASCII 
and HEX conversion tables). 

select one of: jsprompt, telnet, rlogin, tcp_clear, slip or ppp. For more 
information on these user services see Section Configure a User 
Account. 

(use only when you have selected a service of 'telnet' or 'rlogin'); 
select: 

0.0.0.0 for the unit to select the default host set for all users; see 
Section set server. 

255.255.255.255 for the unit to prompt the user for the ip address or 
name of the host to which he/she wishes to connect 

n.n.n.n (where n is a number) for any other ip address of your 
choosing (as system administrator); e.g 192.65.144.6 

t-port number (use only when you have selected a user-service of 'telnet') enter the 
TCP port number of the host with which the unit should start the 
service. The default port is 23; in most cases you can use the default 
value. 

callback-flag whether the unit calls the user back when he/she connects to the unit 
(a security feature). Set either 'on' or 'off (default is 'off'). When 
'on', enter a phone number (see below). 

phone-number a number which the unit will dial to callback the user (you must have 
set 'callback' to 'on'). Enter the number without spaces. To change 
the phone number, overwrite the previous entry. 
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i-timer value enter a period in seconds for which the idle timer will ran. Use this 
timer to close a connection because of inactivity. When the idle timer 
expires, if there has been no exchange of data, the unit will end the 
connection. The default value is 0 (zero), meaning that the idle timer 
will not expire (the connection is open permanently). The maximum 
value is 2 32 seconds. 

The idle timer (here) will override the idle timer which you can 
configure for a line. 

s-timer value enter a period in seconds for which the session timer will run. Use 
this timer to forcibly close a user's session (connection). When the 
session timer expires the unit will end the connection. The default 
value is 0 (zero), meaning that the session timer will not expire (the 
session is open permanently, or until the user logs out). The 
maximum value is 2 32 seconds. 

The session timer (here) will override the session timer which you 
can configure for a line. 

f-ip address use only when the user service field is set to 'slip' or 'ppp'; for more 
information see Section Configure a User Account, sub-section 
framed ip. 

f-netmask ignore this parameter; it is reserved for future use. 

f-mtu value use only when the user service field is set to 'slip' or 'ppp'; for more 
information see Section Configure a User Account, sub-section 
framed mtu. 

/-compression use only when the user service field is set to 'slip' or 'ppp'; for more 
value information see Section Configure a User Account, sub-section 

framed compression. 

session use this argument to predefine sessions for the user. You can 

predefine one specified session (n), or all sessions (*). It takes the 
arguments defined below: 



Session arguments 

. . . session n/* type telnet /rlogin host hostname [termtype 
termtype] [auto on/off] [echo on/off] [mapnl on/off] [mode 
on/off] [intr <hex>] [quit <hex>] [eof <hex>] [erase 
<hex>] [break <hex>] 



You must specify the type and hostname. The other arguments are 
optional. The arguments after auto are telnet options. 
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You can use any number or combination of the arguments. Use the ? command to list the options for each 
one. An example is given below: 

set user julie level normal switch 02 session* 
type telnet host socrates termtype wyse60 
This command has set up four predefined telnet sessions on host socrates for user 'julie'. 

Notes 

1 . You can set all users to the same parameters by using the * asterisk character, e.g. 

set user * language french 
will set all users to this language value. 

Menu equivalent 

Users - Change User/Set Password 

See also 

add user, netioad, show user, delete user, show telnet 

show ARP 

This command is used to display the current ARP table. This is useful for diagnostic and debugging 
purposes. 

This parameter is only accessible from the unit's CLI. 

Syntax 

show arp 

See also 

delete ARP 
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show date 



user levels: This command enables you to show the date in the unit; e.j 
admin, normal d ate2/2/i999 



Syntax 

show date 

Menu equivalent 

Main Menu - hardware 



See also 

set date, set time, show time, show hardware 
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show gateways 

user levels: Use this command to list the gateways you have defined. The list will be displayed in the following format: 
admin, normal 



Hostname 


Type 


Internet Address 


Status 


socrates 


default 




Ac t i ve 


p 1 at o 


host 


192.65.144.4 


Pass i ve 



If you have not entered gateway information your command will be ignored; you will be presented with the 
unit prompt once more. 

Syntax 

show gateways 

Menu equivalent 

Network Configuration - Gateways - Change Gateway 

See also 

add gateway, delete gateway, set gateway 
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show hardware 

user level: This command displays the hardware configuration of your unit. An example display is: 

admin, normal 



JS_S500# show hardware 

mac address 0080ba&0330c 

board id JS4300076R1 . E 

processor 8 0 3 3 & 

uarts 3 * Serial ASIC 

flash ram 1 x 1MB 

ram 2 k 2MB 

battery ram 32kB 

serial ports 2 4 

ethernet interface auto 

ether net speed 10M 

date 13/"5/"2Cl[l3 

time 14:16:17 



Syntax 

show hardware 



Menu equivalent 

Main Menu - Hardware 

See also 

set date, set time, show line, show parallel 

show hosts 

user levels: Use this command to list the contents of the host table: 
admin, normal 



Syntax 

show hosts 



JS_8500# show hosts 

hostname internet address 

pc 172.16.28.100 

Solaris 172.16.0.2 

router312 172.16.1.2 

sco 172 . 16 . 113 . US 
JS 8500# ■ 
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Menu equivalent 

Network Configuration - Host Table - Change Host 

See also 

add host, delete host, set host 

show interfaces 

This command will show all lines with active SLIP or PPP links. It is useful for monitoring the status of dial- 
up lines. This parameter is only accessible from the unit's CLI. 

Syntax 

show interfaces 
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show line 

user levels: This command can be used to display the configuration of a single line or all lines, of the front- 
admln, normal mounted serial RJ45 ports only. Admin users can show all lines, normal users can only display the 
configuration of their own line. The command does not show : 

the Admin Port line configuration; this is fixed - see the Installation Guide, The Admin Port on page 37. 

the parallel port line configuration; see the command show parallel. 

For a single line the display will look similar to this: 



JS_8500# show line 14 




speed 


9600 


terminal 


dumb 


dial 


none 


f low 


none 


bits 


8 


parity 


N 


stop 


1 


pages 


4 


phone number 




modem, name 


none 


idle timer 


0 


session timer 


0 


routing 


none 


service 


j slogin 


hostname 


pc 


host port 


23 


JS port 


23 


current user 




JS 8£00# | 





If you specify all lines, the display will look similar to this: 



JS_85( 


]0# sh 


li * 




line 


speed 


service 




1 


9600 


jslogin 


nouser 


2 


9600 


jslogin 


nouser 


3 


9600 


jslogin 


nouser 


4 


9600 


jslogin 


nouser 


5 


9600 


jslogin 


nouser 


6 


9600 


jslogin 


nouser 


7 


9600 


jslogin 


nouser 


8 


9600 


PPP 


nouser 


9 


9600 


jslogin 


nouser 


10 


9600 


jslogin 


nouser 


11 


9600 


jslogin 


nouser 


12 


9600 


jslogin 


nouser 


13 


9600 


jslogin 


nouser 


14 


9600 


jslogin 


nouser 


15 


9600 


jslogin 


nouser 


16 


9600 


jslogin 


nouser 


17 


9600 


jslogin 


nouser 


18 


9600 


jslogin 


nouser 


19 


9600 


jslogin 


nouser 


20 


9600 


jslogin 


nouser 


21 


9600 


jslogin 


nouser 


22 


9600 


jslogin 


nouser 


< hit 


any key > 




23 


■ : 


jslogin 


nouser 


24 


9600 


jslogin 


nouser 


JS 851 


:io# I 







Note that the user shown in the right-hand column is the 'current user' i.e. the user currently logged in on 
that line. 'Nouser' means there is not a user currently logged in. 
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Syntax 

show line 2ine_numjber 
Where line_number is : 

the current line, 
a specific line number, 
all lines 

Menu equivalent 

Line Configuration - Line Settings 

See also 

set line, show user, show parallel 



n 
* 
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show modems 

user levels: Use this command to show modem details held by the unit, 
admin, normal 

Syntax 

show modem 
This will show (for example): 

name 

Hayes 
US Robotics 
Courier 



initialisation 
string 



Menu equivalent 

Line Configuration - Modems - Change Modem 

See also: 

add modem, delete modem, show line 

Note To change modem details in the cli you must 'delete' the modem, then 'add' it again, with the changed 
details. 
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show parallel 



user levels: If you have a parallel port(s) fitted, this command can be used to display the configuration of a single parallel 
admin line or all parallel lines. 

For a single line the display will look similar to this: 



js 8500# sh pa 1 



hostname 
host port 
JS port 



printer 

plato 

23 

23 



If you specify all lines (and you have more than one parallel port fitted), the display will look similar to this: 



js 8500# sh pa * 








line service 


hostname 


host port 


JS port 


1 printer 


homer 


23 


23 


2 rev raw 


sophocles 


23 


23 



Syntax 



show parallel 1 ine_number 
Where line number is : 



the current line. 

a specific line number. 

all lines 
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Menu equivalent 

Line Configuration - Parallel Port Settings 



See also 

set parallel, reset parallel, kill parallel, show hardware 



show ppp line 



user levels: 

admin, 

normal 



Use this command to show the PPP configuration of a line. Admin users can show all lines; users with 
normal level privileges can only display the configuration of their own line. 



syntax 



show ppp line line_number 

where: 

line_number may also be specified as * for all lines, or . for the current in-use line, 
parameters are any from the list below: 



parameter syntax 



lipaddr 
ripaddr 
subnet 
accm 

mm 

security 
user 

password 

ruser 

rpassword 

ac_comp 

proto_comp 

vj_comp 



parameter name 



local ip address 

remote ip address 

subnet mask 

asynchronous character 
control map 

maximum receive unit 

security 

user 

password 
remote user 
remote password 
address/control compression 
protocol compression 
VJ compression 
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parameter syntax 


parameter name 


magic_neg 


magic number negotiation 


ipaddrjieg 


ip address negotiation 


cr tmrii it 


Vnnfim iro roniioct' timomit 
UUllliyUlC IcLjUcoL lllllcUUl 


trjmout 


'terminate request' timeout 


cr_retry 


'configure request' retries 


tr_retry 


'terminate request' retries 


nak_retry 


'configure nak' retries 


authjmout 


authentication timeout 



The meanings and values of these parameters are explained in Section Configuring PPP . 

Menu equivalent 

Line Configuration - Line Settings 

See also 

set ppp line 
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show radius 

user levels: Use this command to check the RADIUS settings of the unit: 
admin, normal 

Syntax 

show radius 

The output of this command are the RADIUS settings of the unit (e.g.): 



primary authentication host 


p 1 a t o 


secondary authentication host 


home r 


primary accounting host 


p 1 at o 


secondary accounting host 


home r 


retry 


3 


t imeout 


1 


auth port 


1645 


acct port 


1646 


acct authent i cator 


on 


account ing 


on 


session id 


dO 0 0 0 0 0 0 



For details of these parameters, see JETSTREAM 4000, 8500, LANSTREAM 2000, Installation Guide, 
Section RADIUS configuration. 



Menu equivalent 

radius configuration - radius settings 



See also 

add radius, set radius, set server 
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show routes 

user levels: Use this command to give you a better understanding of your network. It will also show a single passive 
admin, normal gateway configured using bootp. Below is an example: 



Destination 


Gateway 






Flags 


Ref s 


Use 


Interface 


192.101.35.192 


192.101 


3 5 


2 17 


U 


1 


1 


leO 


0.0.0.0 


192 .101 


3 5 


2 17 


UG 


0 


0 


leO 



Syntax 

show routes 



Menu equivalent 

there is no menu equivalent 

Note this command is synonymous with the 'netstat -r ' command on most Unix systems. See the manpages (type 
"man netstat" on your Unix system for more information). 



See also 
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show server 

user levels: This command displays the base configuration of the unit, for example: 
admin, normal 



servername 


sti 


mpy 




internet address 


192 


.65. 


144.91 


subnet mask 


2 5 5 


.255 


.255.0 


broadcast address 


192 


.65. 


144 .2 55 


domain name 


per 


le . com 


ip host 


191 


.243 


.221.254 


DNS 








primary 


192 


.165 


.144.5 


s ec ondary 


192 


.165 


.144.7 


WINS 








primary 


192 


.10 1 


.34.211 


s ec ondary 


192 


.10 1 


.34.213 


tftp retry 


5 






tftp timeout 


255 






security 


off 






authentication 


loc 


al 




gui access 


off 






banner 


off 







Fields which are unconfigured will not appear in the list on your screen. 



Syntax 

show server 



Menu equivalent 

server configuration 



See also 

set server, show hardware 
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show sessions 



user levels: 
admin normal 



This command lists your active sessions (including active predefined sessions), for example: 
1 telnet socrates 



Syntax 

show sessions 



Menu equivalent 

User - Set Up User - Set Sessions 



See also 

resume 
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show slip line 

user levels: Use this command to show the SLIP configuration of a line. Admin users can show all lines; users with 
admin, normal normal level privileges can only display the configuration of their own line. 



syntax 

show slip line line_number 

where 

:line_number may also be specified as * for all lines, or . for the current in-use line, 
parameters are any from the list below: 



parameter syntax 



lipaddr 

ripaddr 

subnet 

mtu 

priority 

transmiLparameters 

icmp_suppress 

vj_comp 



parameter name 



local ip address 
remote ip address 
subnet mask 

maximum transmission unit 
interactive priority 
transmit parameters 
suppress icmp 
VJ compression 



The meanings and values of these parameters are explained in Section Configuring SLIP. 



Menu equivalent 

Line Configuration - Line Settings 

See also 

set slip line 
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show snmp 

user levels: This command shows the configuration of the unit for SNMP support; for example: 



admin, normal 



snmp 


contact 


miked 










snmp 


location 


x2 3 5 










snmp 


communi ties: 


1 . homer 


192 


6 5 


144 


7 8 read/ write 






2 . local 


192 


6 5 


144 


2.55 read only 


snmp 


traps : 


1 . local 


192 


6 5 


144 


255 



Syntax 

show snmp 

Menu equivalent 

network configuration - snmp 

See also 

add community, add trap, set contact, set location 
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show telnet 

user levels: Use this command to show telnet parameters on a line. Note that telnet parameters shown here apply only 
admin, normal to line service types of: 

Direct telnet 
Silent telnet 

The command also shows telnet parameters entered using the command set telnet. 



JS_8 


500# 


show 


telnet 


line 


* 








line 


echo 


mapnl 


mode 


intr 


qui t 


eof 


erase break 


terminal 


1 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


2 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


3 


off 


off 




off 


7f 


lc 


04 


08 Id 


vtlOO 


4 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


5 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


6 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


7 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


• 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


9 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


10 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


11 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


12 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


13 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


14 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


15 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


16 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


17 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


IS 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


19 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


20 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


21 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


< hit any 


key 


> 














22 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


2 3 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


24 


off 


off 




off 


7f 


lc 


0 4 


08 Id 


vtlOO 


JS 8 


500# | 


1 

















Syntax 

show telnet line 1 ine_number 
Where: 

line number is the serial line number connected 



Menu equivalent 

not available in the text menus 



See also 

set telnet 
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show time 



user levels: This command enables you to show the time as measured by the real-time clock in the unit; e.j 
admin, normal . . , , . . , ,, 

' timell : 04 : 32 



Syntax 

show time 

Menu equivalent 

Main Menu - hardware 



See also 

set date, set time, show date, show hardware 



show user 

user levels: Use this command to display a user's setup, including predefined sessions. The admin user can show 
admin, normal details of any user, a normal user can only view their own details: 



JS_8500#" show user julie 










username 


julie 










language 


english 










screen switch 


01 










level 


normal 










service 


jsprompt 










ip_host 


0.0.0.0 










tcp port 


23 










callback 


off 










phone number 












idle timer 


0 










session timer 


0 










framed ip 


255 . 255 . 255 . 254 










framed net mask 


0.0.0.0 










framed mtu 


1500 










framed compression 


on 










rout ing 


none 










type hostname 


auto echo mapnl mode 


intr 


qui t 


eof 


erase break terminal 


1 telnet pc 


off off off off 


7f 


lc 


0 4 


08 Id 


2 telnet Solaris 


off off off off 


It 


lc 


0 4 


08 Id 


JS 8500# | 













Syntax 

show user . / username 
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Where: 



username 



specifies the current user, 
is the name of a specific user. 



Menu equivalent 

Admin user: Users - Change User/Set Sessions. 
Normal user: Sessions - Set Up User/Set Sessions 



See also 

set user 



start 

all users Use this command to start a predefined session. This is a particularly important command for restricted 

users who can only start sessions predefined for them by system administrator. If you are using telnet, the 
target host will prompt you for your login name. If you are using rlogin, the host will prompt you for your 
password. If you are using rlogin and your unit's login name is entered in the 'rhost' file of the target login 
directory, you will be logged straight in. 



Syntax 

start n 

Where n is the predefined session that you want to start. 



Menu equivalent 

Sessions - Start Predefined Session 



See also 

resume 
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telnet 

user levels: This command will establish a connection with another host on the network using the telnet protocol. You 
admin, normal must specify the target host but the other arguments (such as echo, mapnl, mode, etc.) are optional. If you 

do not specify the other arguments the line telnet values will be used (values set/shown in set telnet 

or show telnet) 

If you do specify arguments such as echo, mapnl, mode, etc. the values you enter will override the line 
telnet values. Note that your values (specified here using the telnet command) expire when your telnet 
session is finished; values set/shown in set telnet or show telnet can be saved permanently. 

When the connection is made you will be prompted for your login name. 



Syntax 



telnet hostname / inetaddres s [termtype termtype] [echo on/ 
off] [mapnl on/off] [mode on/off] [intr <hex>] [quit 
<hex>] [eof <hex>] [erase <hex>] [break <hex>] 



Where: 



hostname/ is the name or internet address of the machine you want to log into 

inetaddress 

termtype is your terminal type. This argument enables you to pass your 

terminal type to the host. When connecting to a UNIX host, you must 
define the termtype in accordance with its UNIX TERM variable. 

The termtype argument overrides a termtype value entered into the 
unit when using the set line or set telnet commands. 

echo, mapnl, etc. these are telnet options. They set values once only, for the duration of 
a single telnet connection. See comments under Section telnet above. 



Menu equivalent 

Users - Set Sessions (to set default values) 
or 

Sessions - Start telnet (to use or override default values) 



See also 

kill session, resume, rlogin, set telnet, show sessions, show telnet, start 
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version 

user levels: This command tells you what version of software your unit is running, 
admin, normal 

Syntax 

version 



Menu equivalent 

Version of software is displayed at the top of any menu display, e.g. : 



user [admin] JETSTREAM 2.00 i.l telnet 1 



The text in the middle of the line ( JETSTREAM) will display the name of your product. 
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Appendix A Summary of Line Service 
Types 

When you are configuring a line on the JETSTREAM 4000, 8500 or LANSTREAM 2000 (the 'unit') you 
will find a parameter for a line called 'service'. The detail of types of line service available are shown 
below. 

Note do not confuse line 'service ' with user 'service '. User 'service ' is a completely different parameter from line 
'service ' and is used by the unit in different ways. 

Line 



Service 


Description/Uses 


Example 


How to setup 


Type 








Bidir 


Allows a bidirectional modem A UUCP connection for batch 


Section Host to 




connection on a port 


file transfer and printing. 


host: bidirectional 








Modem 








Connections 


Direct 


When using the unit as a 


Users on terminals. 


Section Login 


telnet 


Terminal Server, to bypass 




direct to host 


orrlogin 


the unit and allow users to 








login straight into a specific 








host. These are non- 








permanent connections 






Direct Raw 


Enables external non-login 


On dialin connections: user 


in the same way 




devices to access TCP/IP 


applications for devices such as as a 'silent raw' 




servers via the unit. 


bar code readers and smart 


connection; see 




No authentication will take 


cards. 


Section External 




place. The connection is set 




host: Dialin 




up from the unit to a TCP/IP 




Modem 




network host (the opposite of 




Connections 




Reverse Raw). These 








connections are established 








by pressing <return>. 






jslogin 


The default connection. 


a) System administrator to do 


for b) Section 




The unit presents a login on 


unit configuration 


Login for 




that line. 


b) Users to starting the unit's 


Sessions 






sessions to hosts. 


for c) Section 






c) Providing authentication of a 


Setting Up the 






user before starting a user 


Line 






'service' of SLIP 
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Line 



Service 


Description/Uses 


Example 


How to setup 


Type 








PPP 


a) Remote access 


A mobile employee 


Section Setting 




connection 




Up the Line and 




b) Using the unit as a router 


Joining together two networks 


Section 




(two units back-to-back) 




Configuring PPP 


Printer 


Using the unit as a printer 


Remote printing using LPD or 


Section Remote 




server 


RCP 


Printing using 








LPD and Section 








Remote Printing 








Using RCP 


Reverse 


Simple pipe between a TCP/ 


To access printers or dialout 


Section Remote 


Raw 


IP host and a machine/device 


modems (with separate host- 


Printing Using 




attached to a port on the unit. 


based print/modem handling 


Host-Based Print 




The connection is set up from 


software). 


Handling Software 




the TCP/IP host on the local 




see also: 




network to the unit (the 




Local host: 




opposite of Direct Raw and 




Dialout Modem 




Silent Raw). 




Connections on 








page 44 


Reverse 


Enables a TCP/IP host to 


To access machines like 


Section Reverse 


Telnet 


establish a login connection 


protocol converters or statistical Telnet connection 




on an external machine 


multiplexors. 






attached to a port 






Silent 


When using the unit as a 


Users on terminals. 


Section Login 


telnet 


Terminal Server, to bypass 




direct to host 


or rlogin 


the unit and allow users to 








login straight into a specific 








host. These are permanent 








connections, therefore 








consume system resources 
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Line 

Service Description/Uses Example How to setup 

Type 



Silent Raw Enables external non-login Dialin connection from an Section External 
devices to access TCP/IP external host machine. host: Dialin 

hosts via the unit. The Modem 
connection is set up from the Connections 
unit to a TCP/IP network host 
on the local network (the 
opposite of Reverse Raw). 
These connections are 
established automatically; 
they are suitable for 
computer to computer 
communications. 



SLIP a) Remote access A mobile employee Section Setting 

connection Up the Line and 

b) Using the unit as a router Joining together two networks Section 

(two units back-to-back) Configuring PPP 
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Appendix B Troubleshooting 



Introduction 

This appendix contains solutions for problems that may arise while using the JETSTREAM 4000, 8500 or 
LANSTREAM 2000 (the 'unit'). 

- if you bought your unit from a registered Perle Supplier, you must contact their Technical Support 
department; they are qualified to deal with your problem. 

- if you are a registered Perle Supplier, and bought your unit from Perle, please contact the Technical 
Support department of your nearest Perle office. The addresses and telephone numbers of your nearest 
Perle office are contained in Appendix F (Contacting Perle). 

Contents 

• General communication matters 
BOOTP/DHCP problems 

• Callback problems 
' Host problems 

Hub problems (LANSTREAM only) 

• JETset problems 

' Language problems 
' Login problems 
' Modem problems 
MTSD problems 

• PPP problems 

• Printing problems 

• Saving to FLASH memory 

• Telnet/Rlogin problems 

• Problems with terminals 
' Emergency Recovery 
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General communication matters 

General communication checks and practices are as follows: 

• ping your host; if you cannot ping at all, check the cabling between the unit and your network. If you 
can ping but packet loss is reported, ping another host/device on the same network. You will 
appreciate whether the problem is specific to a host/device or general to the network. If there is a 
problem with the network check the state of the network, including number of nodes. 

• after entering or changing ip information for your unit (internet address, broadcast address, subnet 
mask) reboot the unit (does not apply when using BOOTP or DHCP). Once the unit has rebooted other 
network devices can communicate with it (ping, telnet, etc.). Also, protocols such as ARP and proxy- 
ARP will work properly 

If you don't reboot unit the ip information you have entered/changed will not be recognised by other 
network devices. 

• use the show routes command (command line only). See if there a route to the host? 

• implement load-balancing in your network by distributing the processing. For example, try not to 
cluster devices on the unit which require high throughput. 

• ensure routes to/from your host are as direct as possible; e.g. ensure the unit is on the same network as 
your host so that bridges/routers do not act as bottlenecks. 

• if your network is congested, subnet it with a bridge; however, bear in mind the recommendations in 
the previous paragraph. 



BOOTP/DHCP problems 

Messages: "host name too long" or "filename too long" 

• the unit can only accept hostnames or filenames of the same maximum length as permissible in the text 
menus or cli. 

Problem: DHCP or BOOTP have been set up to configure my unit but does not seem to have done 

anything. 

Check: Check that the server dhcp parameter is set to on, if not set it to on and reboot. 

If your unit is brand new or has been factory reset, you may see the message: 
INIT: Attempting Rarp 

This means that you have no active BOOTP or DHCP servers on your network. 

Check that your BOOTP server is configured for your unit or that your DHCP server has 
an active lease pool ( scope ) with at least 1 free IP address. 

Problem: You observe TFTP errors when the unit boots, for example: 

TFTP: File not found : filename 

TFTP: Timed out 
This has a number of causes, including: 
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• The filenames you specified to BOOTP/DHCP do not exist or are in the wrong place. 

• DHCP has previously leased bootfile information to the unit ( which it has stored for the duration of 
the lease ), but you have since changed the location or name of the bootfile. 

• Your DHCP/BOOTP server has no TFTP server running and/or the server for any of the downloadable 
files in your bootfile has no TFTP server running. 

Check: Ensure that lease data in your DHCP server manager is correct. 

Reset or restart the DHCP server. 

If this does not resolve the problem, the DHCP lease can be restarted by resetting the unit to factory defaults 
and rebooting. We recommend that you store your unit's configuration before doing this. It can then be 
reloaded when the unit is booting from DHCP correctly. 

Callback problems 

fixed callback is on but the unit is not calling the user back 

other factors: you have a phone number configured for that line. 

• enter a phone number for the user. The unit will only callback using the number configured for that 
user; this is a different 'number' parameter from the number you can configure for a line. 

• check the modem at the user's end is set to 'auto-answer'. 

Host problems 

Cannot access a host by name 

• if using DNS or if DNS is required, ensure a nameserver is configured on your unit and is accessible 
(ping it). 

• if not using DNS, ensure the host is configured in the host table. Check access to the host by pinging it 
using the host's IP address. 

Cannot access a host on a local network 

ensure: 

• the network address is correct. 

• the subnet mask is set correctly and reflects the network configuration. 

• the broadcast address is set correctly and reflects the network configuration. 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



225 



perfe 



Cannot access a host on a remote network 

• use the show route command to verify that there is a route to the remote host. If no gateway is 
specified, ensure a default gateway is specified. Ping the default gateway to check if it is working. 

• Consider the situation beyond the gateway; e.g. are intermediate gateways and the remote host 
available? Also, check the messages returned by the show route command; e.g. that a particular host 
or gateway is unreachable. 

Gateways added into the gateway table are ignored by the unit 

• have you used BOOTP and entered a single static gateway in the bootptab file entry? If yes, the other 
gateways will be ignored. See 8500 Configuration Guide How to setup BOOTP on page 102 for more 
information 

Access to host lost after a few minutes 

• If the route to this host goes through routers, make sure those routers are all sending RIP packets 
across the networks. 

You see a message saying your host is in use. 

• delete your host as either, a DNS or WINS host, or a gateway, then retry the 'delete host' command/ 
menu item. You may have configured your host as a DNS or WINS host, or a gateway. 

The connection fails when the user 'ip host' parameter is set to 0.0.0.0 

other factors: several hosts are entered in the unit's host table 

• check the host ip address entered in the server configuration; it is this ip address - and not hosts in the 
host table - which the unit will use when a user's ip_host is set to 0.0.0.0 

Hub problems (LANSTREAM only) 

You have a connection into the 10BaseT 'uplink' port (on rear panel), but you cannot 
communicate to your connected device. 

• On the 'uplink' port check if the green 'Link OK' LED is on. If the LED is off you have a bad link. 
This is probably caused by the switch marked 'HUB - UPLINK'(next to the port) being in the wrong 
position. Move the switch to the opposite position. Now see whether the 'Link OK' LED is on (steady 
green); if the LED is on you have a good link. 

• Check that the Receive and Transmit signal pairs are connected as follows: 



Connected device 


direction of signal LANSTREAM 


Receive pair 


< Transmit pair 


Transmit pair 


> Receive pair 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



226 



perfe 



JETset problems 



Trying to access JETSET you see an 'alert' dialog box, e.g. 



Figure 33 



Netscape 



□ 



|\ JavaScript Alert: 

* \ JETset access denied: Web server disabled 



OK 



change the parameter 'gui_access' to 'on'. 



Problems with JETstart 



Problem: I can't save the configuration generated with JETstart. 

Check: You need to set up JAVA applet security before you can save a file to your hard disk. 

Problem: I neeed to use the scroll bars to see the whole applet. 

Solution: Drag the frame bar dividing the title frame from the applet frame to the top of the browser 
window. 

Problem: JETstart applet doesn't load. 

Check: Check your browser version against the list of supported versions. 

Problem: Can't see all the text in an error message. 

Solution: Click OK and cause the error to re-occur. The text will then be visible. 



Language problems 



in a customised language, the text strings appear in the wrong place in the text menus 
and cli. 

check the original ascii text file you used to translate to your customised language. The sequence of 
lines must be maintained; so if 'set line' appeared on the 60th line in the original file, the translation of 
'set line' in your custom language must appear on the 60th line in your language file. 



Login problems 



For login problems see also 'Section Telnet/Rlogin problems' 
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User is waiting up to 60 seconds before login is accepted or denied 

other factors: authentication is set to 'both' or 'RADIUS'. User has entered username and password, 
and has pressed <return> key. 

• check RADIUS configuration of primary and secondary authentication/accounting hosts specified, and 
you have retry and timeout values greater than the default, the unit will be spending time trying each of 
these hosts and keeping the user waiting. 

• adjust RADIUS configuration: specify just one host, reduce timeout and retry values to the default or 
less than default. 

You cannot progress beyond the 'login' and 'password' prompts 
(when authentication is set to either 'both' or 'RADIUS') 

• check the setting of 'account_authenticator' flag is the same in the unit and the RADIUS host; either 
they should both check or both ignore the authenticator field. If you are not sure, change the setting in 
the unit; see if this fixes the problem. 

• on the RADIUS host check the secret (password); you should see it displayed in clear text in the 
RADIUS clients file. If you are unsure whether it is the same secret which you entered in the unit, go 
to the unit and re-enter a new secret. 

• on the RADIUS host check there is only one entry for a particular user; do not have multiple entries of 
the same username (although passwords may be different). 

You cannot obtain a login on any of the front-mounted ports 

• Connect via the Admin port and check the settings of the front-mounted ports; they have probably 
been set to 'direct' or 'silent' telnet/rlogin. 

You have lost or don't know your password (as 'admin' user) 

• you must reset the unit to its factory default settings using the 'reset' switch on the rear panel. There is 
no procedure to access the unit without a password. 

Using a terminal, you see garbled characters or no characters at all 

other factors: you are connecting to the unit from a terminal via a modem 

• your terminal is set to a different baud rate to the line into the unit. Send a line break (<break> key) 
and the unit will try the next line speed setting.For more information see Section Logging in. 

Error message: 'Warning: Baud Rate Changed to new_speed' 

other factors: you are connecting to the unit from a terminal via a modem 

• you will see this message after sending a line break (<break> key); the unit has tried the next line 
speed setting. Your action is acceptable: your terminal is set to a different baud rate to the line. For 
more information see Section Logging in. 
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Modem problems 

the unit is not initializing the modem 

• check your line service is set to jslogin, slip or ppp. If your line service is set to any other type, the unit 
will not initialize a modem. You will need to configure the modem manually. 

see also Login problems 

MTSD problems 

MTSD works erratically 

• On some operating systems, the system timeouts used to establish and break network connections can 
disrupt the operation of MTSD. To avoid this, check the arguments you are using with MTSD 
commands. Type mtsd -help and see the applicability of each command. 

• Include or take-out arguments which you feel are appropriate. 

see also Printing problems 

PPP problems 

the link fails on start-up (problem #1) 

other factors: there are remote ip addresses set for both a user ('framed ip' value) and a line ('remote IP 
address'). 

• check the IP address set for the user; this is used in preference to the ip address set for a line. If there is 
a problem with the user's IP address, negotiation will fail; the unit will not use the line's IP address as 
an alternative. 

the link fails on start-up (problem #2) 

other factors: security (either PAP or CHAP) is enabled on the line. 

• check the remote client/device has the same setting; i.e. PAP if the unit is using PAP. The unit does not 
perform negotiation with the remote end over PAP or CHAP. 

at the remote end the client software locks up 

other factors: security (CHAP) is enabled on the line. 

• disable CHAP re-challenge parameter (challenge_interval) in the unit. Some PPP client software does 
not work when receiving CHAP re-challenges. 
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Printing problems 

the print job fails to print on the device attached to the serial or parallel ports 

• on the line where the printer is attached, set line service to printer . Print jobs will not print when 
the line service is set incorrectly. 

when using RCP, the network host receives a rejection message from the Perle unit. 
The result is that the print job does not take place. 

• print using LPD, or 

• modify the printer interface scripts on the network host to overcome this weakness of RCP. The 
modification will force the network host to continue trying to send the print job when the unit's printer 
port is busy. 

Saving to FLASH memory 

The POWER and NETWORK LEDs display the following colours: 

(as shown in Figure 34) 
Figure 34 LED display: failure of load to FLASH 

JETSTREAM 8500 LANSTREAM 




The Network LED flickers green if network traffic is identified on the network ports. 

• If you were loading a new version of software try again using the Admin Port. The save to FLASH has 
failed. 
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Telnet/Rlogin problems 

For login problems see also 'Section Login problems' 

Message 'unauthorised client' when using telnet (or rlogin) to access the unit via a 
network port: 

• check the 'security' feature. Security may be 'on' in the unit and you are trying to access the unit via 
an unauthorised host. 

Message 'no pseudo devices available' when using telnet (or rlogin) to access the unit 
via a network port: 

• there are already the maximum number of telnet/rlogin sessions connecting to the unit via its network 
port. Close down one of the other sessions. 

Problems with terminals 

see also: Section Login problems. 

The following section concerns problems with the appearance of data on your terminal screen: 

The unit logs me out after a few minutes 

• Change the idle timeout value set for the user. The idle timeout for all users is set to 300 seconds (5 
minutes) by default, because the unit is designed for remote access connections (using SLIP or PPP). 

Corrupt data 

• check your line settings (baud rate, stop bits, etc.) 

Missing data 

• ensure the same type of flow control is set in both your terminal and on the unit's port. 

Error message 'not permitted on a dumb terminal' after typing the cli command 'screen' 

• set your line to 'termtype' VT100, ansi or Wyse60 (or other form of terminal emulation, if you have 
downloaded one). The default line type in the unit is 'dumb' which does not support the graphics 
characters necessary to view the text-based menus. 

Screen corruption when using the text-based menu system 

• check that the terminal setup in the unit matches your terminal. 

• check that entries in the term file match your terminal setup. 
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• if using a PC/computer, ensure the type of terminal emulation selected in your application matches 
those supported by the unit. If you still have the problem, you may be suffering with poorly written 
terminal emulation in your application. Instead use the command line mode; if you have a web 
browser use JETset. 

When using the function keys on your keyboard, nothing happens or your sessions 
keep swapping. 

• Change your screen switch character. The function keys on the keyboards of some terminals (e.g. 
Wyse 60) send character sequences which begin with A a; unfortunately, A a is also the default screen 
switch character, or 'hot- key', which you use to switch between sessions. A valid alternative would be 
A b (hex=02). 

If you are the system administrator, you can change any user's screen switch character. 

When using a downloaded terminal definition, you are having problems using arrow 
keys. 

• Use Ctrl-K, Ctrl-J, Ctrl-H and Ctrl-L for up, down, left and right respectively. 

When switching from a session back to the text menus, both screen images are 
superimposed. 

• Press A r to redraw the screen. 

INIT: Error in terminal file <filename> 

• This error indicates that you have exceeded the 80 character limit for one or more of the terminal 
capabilities defined in the reported file. 

INIT: Error on line n in terminal file <filename> 

• You have omitted the '=' sign from the reported line. 



Problems with Framed Routing 



Problem: 



My SLIP/PPP link is running but I am not seeing any routing information propagated to 
my dial up clients. 



Check: 



Make sure that SLIP/PPP links are configured for route broadcasts, see section 9.1. 
Wait for 30 seconds before checking again for new routes, routes are broadcast every 30 
seconds. 



Problem: 



I can talk to my dial-up clients, but not any other machine on the network it is attached to. 



Check: 



Make sure that your dial-up client is configured to pass on RIP ( routing ) packets to it's 
other network interfaces. This may involve installing additional routing software on some 
operating systems. 

I have configured framed routing for a SLIP/PPP link but routing does not work. 



Problem: 
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Check: Both Remote IP Address and Local IP Address need to be configured with valid IP 

addresses for framed routing to remote clients to operate. 

Emergency Recovery 

Problem: 

You have a unit already configured and, 

- you do know your password, but 

- have lost, misconfigured or don't know the IP address of the unit, and 

- you cannot obtain a login on any port (including the console port) 
The emergency recovery method is to use BOOTP (see Section BOOTP). 

• Setup a host machine on your network to run BOOTP. Using the ethernet address of the unit (printed 
on the base of the product) BOOTP will assign the unit a known IP address. 

• Now, you should be able to telnet into the unit and change its IP address. 

Using BOOTP to recover access to your unit in this manner will preserve all configuration settings - apart 
from the IP address. 
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Appendix C SLIP and PPP overview 

Introduction 

This appendix describes the main features of SLIP and PPP. 

SLIP 



Overview 

The Serial Line Interface Protocol (SLIP) is a simple but crude protocol for transporting IP datagrams over 
serial links; (a datagram is defined as a number of bytes of user information sent from the sender to the 
receiver). It is an old protocol dating back to the mid-nineteen eighties. It is specified in RFC 1055; see 
Appendix D (References). 

SLIP has two forms: SLIP and compressed SLIP (C-SLIP). The unit supports both SLIP and C-SLIP; the 
default version is C-SLIP. See C-SLIP on page 237 for more information on C-SLIP. 

The way SLIP encapsulates IP datagrams is shown in Figure 35. The datagram is terminated by a special 
character called END. Most applications also transmit an END character at the beginning of a datagram, to 
prevent line noise being interpreted as part of the datagram. 

There may be one or two ESCAPE characters, depending on the content of bytes in the information fields. 
Therefore the ESCAPE characters are not always transmitted. In our example the number of bytes in the 
SLIP frame is the length of the IP datagram plus an overhead of 4 bytes. 

SLIP has a number of deficiencies which are discussed in Deficiencies on page 236. Despite these 
deficiencies SLIP is a popular protocol, still widely used; however, PPP is becoming more popular than 
SLIP. 
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Figure 35 SLIP framing 
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Deficiencies 

1. You cannot use software flow control; therefore, you must use hardware flow control. Software flow 
control uses xon/xoff characters, which SLIP is unable to escape to the datastream. 

2. SLIP can lead to errors since there is no checksum in the SLIP frame. If a noisy phone line corrupts a 
datagram being transferred by SLIP, the upper layers must detect them. This problem is less serious 
with TCP/IP (where upper layers provide a checksum) but more serious with UDP (where upper 
layers optionally provide a checksum). 

3 . The remote client cannot obtain an IP address from the server, so the remote end must obtain an IP 
address another way (e.g. a script). 

4. SLIP is often used for interactive traffic such as Telnet or Rlogin, where small numbers of characters 
are sent in a datagram (e.g. a word of only a few letters, such as 'help'). Telnet and Rlogin both use 
TCP so the IP datagram is accompanied by a TCP/IP header, 40 bytes in length. This header is a large 
overhead for a small datagram; i.e. the word 'help' is 4 bytes; it would occupy 40 + 4 = 44 bytes with 
the TCP/IP header. This overhead leads to poor perfomance with interactive traffic. 

To overcome these problems, a newer version of SLIP has been developed called compressed SLIP or 
C-SLIP; see C-SLIP on page 237. 

5. SLIP supports only the IP protocol; it cannot transmit multiple network protocols over the same 
single serial line. 
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C-SLIP 

A newer version of SLIP was developed called compressed SLIP (or C-SLIP), to overcome the performance 
problems of SLIP. This is specified in RFC 1 144 (see Appendix D (References)). C-SLIP reduces the 40 
byte TCP/IP header to 3 or 5 bytes, greatly improving interactive response time; see Figure 36. 

C-SLIP is the default version of SLIP in the unit and is represented by the SLIP parameter called 'VJ 
Compression' (for Van Jacobson compression); when turned 'on' the TCP/IP header is compressed and you 
are therefore running C-SLIP over your link. VJ compression is 'on' by default; Section Configuring SLIP 
shows you where to find this parameter in the text menus and cli. 



Figure 36 



Compressed SLIP (C-SLIP) 
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1 this figure denotes the size of the field, in bytes 



ESCAPE characters are not shown here (see Figure 35) 



PPP 



Overview 

The Point-to-Point Protocol (PPP) is a modern and reasonably sophisticated protocol for transporting IP 
datagrams over serial links; (a datagram is defined as a number of bytes of user information sent from the 
sender to the receiver). It is specified in RFC 1055; see Appendix D (References). 

The way PPP encapsulates IP datagrams is shown in Figure 37. The format of PPP frames resembles the 
ISO HDLC (high-level data link control) standard. 
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Figure 37 PPP framing 
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Each frame begins and ends with a FLAG byte. This byte is followed by ADDRESS and CONTROL bytes. 
Next is a PROTOCOL field which indicates the content of the INFORMATION field; e.g. whether the 
information field is an IP datagram, link control data or network control data. The CRC field (or FCS, 
meaning 'Frame Check Sequence') is a cyclic redundancy check, to detect errors in the frame. 



How PPP works 

Once the hardware of the link is connected and is operational, PPP operates using a Link Control Protocol 
(LCP) and a family of Network Control Protocols (NCPs). This operation - which happens in a very specific 
order - is explained in Figure 38. 
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Figure 38 



Operation of PPP 



Sequence of events 
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the physical layer and its 
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correctly; obvious, but the 
cause of so many problems 



The NCP for IP is IPCP (IP Control Protocol); in the unit the only networking layer datagrams you are 
sending over your link are IP datagrams. 

Implementations of PPP are becoming more widely available and so the number of users of PPP is growing 
PPP is probably now used more than SLIP. 



Advantages 



1. You can use either hardware or software flow control. 

2. You should experience less errors since there is a checksum on every frame. 

3. The remote client can obtain an IP address from the server - i.e. there is dynamic negotiation of the IP 
address (of each end). 



JETSTREAM 4000, 8500, LANSTREAM 2000, Configuration Guide 



239 



perfe 



4. There is TCP/IP header compression (similar to SLIP) where the 2x20 byte header is reduced to 3 or 
5 bytes (see Figure 36). This compression is represented by the PPP parameter called 'VJ Comp' (for 
VJ Compression); when turned 'on' the TCP/IP header is compressed. VJ compression in 'on' by 
default; Section Configuring PPP shows you where to find this parameter in the text menus and cli. 
VJ compression increases perfomance with interactive traffic. 

5. Security on the link is provided by the protocols PAP and CHAP. PAP operates at start-up of the link, 
authenticating the remote user. CHAP operates at start-up of the link and at regular intervals. The 
regular frequency of CHAP ensures that a link remains secure during a session. 

The default security protocol in the unit is CHAP. Also, you can configure the interval with which 
CHAP re-challenges the remote end during a session. 

6. PPP supports multi-protocols over a single serial line. 

7. PPP transmits data over both synchronous and asynchronous lines; in the unit support for PPP is for 
asynchronous lines only. 
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Appendix E ASCII and HEX 
conversion tables 



Introduction 

This appendix contains the following: 

• Section ASCII to Decimal and Hex Conversion Chart 

• Section Binary to Hex Conversion Chart 



ASCII to Decimal and Hex Conversion Chart 



ASCII 


DEC 


HEX 


NUL ( A @) 


000 


00 


SOH ( A A) 


001 


01 


STX ( A B) 


002 


02 


ETX ( A C) 


003 


03 


EOT ( A D) 


004 


04 


ENQ ( A E) 


005 


05 


ACK ( A F) 


006 


06 


BEL ( A G) 


007 


07 


BS ( A H) 


008 


08 


HT ( A l) 


009 


09 


LF ( A J) 


010 


OA 


VT ( A K) 


011 


0B 


FF ( A L) 


012 


OC 


CR ( A M) 


013 


0D 


SO ( A N) 


014 


0E 


SI ( a O) 


015 


OF 


DLE ( A P) 


016 


10 


DC1 ( A Q) 


017 


11 


DC2 ( A R) 


018 


12 




ASCII 


DEC 


HEX 


9 


057 


39 




058 


3A 




059 


3B 


< 


060 


3C 




061 


3D 


> 


062 


3E 


? 


063 


3F 



ASCII 


DEC 


HEX 


DC3 ( A S) 


019 


13 


DC4 ( A T) 


020 


14 


NAK ( A U) 


021 


15 


SYN ( A V) 


022 


16 


ETB ( A W) 


023 


17 


CAN ( A X) 


024 


18 


EM ( A Y) 


025 


19 


SUB ( A Z) 


026 


1A 


ESC 


027 


1B 


FS 


028 


1C 


GS 


029 


1D 


RS 


030 


1E 


US 


031 


1F 


SP 


032 


20 


! 


033 


21 




034 


22 


# 


035 


23 


$ 


036 


24 


% 


037 


25 




ASCII 


DEC 


HEX 


Q 


081 


51 


R 


082 


52 


S 


083 


53 


T 


084 


54 


U 


085 


55 


V 


086 


56 


w 


087 


57 



ASCII 


DEC 


HEX 


& 


038 


26 




039 


27 


( 


040 


28 


) 


041 


29 




042 


2A 


+ 


043 


2B 




044 


2C 




045 


2D 




046 


2E 


/ 


047 


2F 


0 


048 


30 


1 


049 


31 


2 


050 


32 


3 


051 


33 


4 


052 


34 


5 


053 


35 


6 


054 


36 


7 


055 


37 


8 


056 


38 




ASCII 


DEC 


HEX 


i 


105 


69 


j 


106 


6A 


k 


107 


6B 


I 


108 


6C 


m 


109 


6D 


n 


110 


6E 


0 


111 


6F 
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ASCII 


DEC 


HEX 


@ 


064 


40 


A 


065 


41 


B 


066 


42 


c 


067 


43 


D 


068 


44 


E 


069 


45 


F 


070 


46 


G 


071 


47 


H 


072 


48 


1 


073 


49 


J 


074 


4A 


K 


075 


4B 


L 


076 


4C 


M 


077 


4D 


N 


078 


4E 


0 


079 


4F 


P 


080 


50 



ASCII 


DEC 


HEX 


X 


088 


58 


Y 


089 


59 


Z 


090 


5A 


[ 


091 


5B 


\ 


092 


5C 


] 


093 


5D 


A 


094 


5E 




095 


5F 


■ 


096 


60 


a 


097 


61 


b 


098 


62 


c 


099 


63 


d 


100 


64 


e 


101 


65 


f 


102 


66 


g 


103 


67 


h 


104 


68 



ASCII 


DEC 


HEX 


p 


112 


70 


q 


113 


71 


r 


114 


72 


s 


115 


73 


t 


116 


74 


u 


117 


75 


V 


118 


76 


w 


119 


77 


X 


120 


78 


y 


121 


79 


z 


122 


7A 


{ 


123 


7B 


I 


124 


7C 


} 


125 


7D 




126 


7ES 


DEL 


127 


7F 
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Binary 


Hex 


1010 


A 


1011 


B 


1100 


C 


1101 


D 


1110 


E 


1111 


F 



Notes: 

To represent two letters/two numbers flow binary numbers sequentially, so : 
OF is 0 followed by F, i.e. 0000 followed by 1 1 1 1 . 
OF is therefore 0000 1 1 1 1 in binary. 

Likewise, the binary digits 101 10100 would equate to: 
101 1 followed by 0100, which is B followed by 4; 
therefore 101 10100 is B4 in hex. 
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Appendix F Contacting Perle 

You need to You need to read this appendix if you want to contact Perle for technical support or any other queries about 
read this this product. 

appendix if you appendix includes the following sections; 
want to... FV 6 

• Making a technical support query on page 248 

• Repair procedure on page 251 

• Feedback about this manual on page 252 

• Perle support centres worldwide on page 253 

internet access 



Click here to access the our website at 
the following URL: 
http://www.perle.com 



Email 



Click here to email Perle at the following address; 
Email: support@perle.com 
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Making a technical support query 

This section contains the following information about making a query; 

• Who to contact on page 248 

• Information needed when making a query on page 249 

• Making a support query via the Perle web page on page 250 



Who to contact 

If you bought your product from a registered Perle supplier, you must contact their Technical Support 
department; they are qualified to deal with your problem. 

If you are a registered Perle supplier, and bought your product from Perle, contact Perle Technical Support 
at the offices listed below. 
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Information needed when making a query 

When you make a technical support enquiry please have the following information ready; 



Hint 

Print out this page and fill in the table provided with the basic 
information you need. 



Item 


Write details here 


Product name and version 




Problem description 




Operating system version 




Driver version 




Details of any other cards 
installed in your system 




Your name 




Company Name 




Country 




Phone number 




Fax number 




Email address (if available) 
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Making a support query via the Perle web page 

If you have an internet connection, please send details of your problem to Technical Support using the 
email links provided on the Perle web site in the 'Support' area. 

See also Perle support centres worldwide on page 253 for email links and other contact details for the 
Perle technical support centres. 



Click here to access our website at the following URL: 
http://www.perle.com 
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Repair procedure 

Before sending a unit for repair, you must contact your Perle supplier. If, however, you bought your 
product directly from Perle you can contact directly. See Perle support centres worldwide on page 253 
for contact information. 

Customers who are In Europe, Africa or Middle East can submit repair details via a website form shown in 
the next picture. This form is on the Perle website, www.perle.com, in the Support area. 



Click here to access our web site at the following URL: 
http://www.perle.com/support/rma_form.html 



In the USA and Asia contact the office shown in the Technical Support section. 



Website RMA (Return Material Authorisation) Form 



_http:/ 


'www.perle.com/support/rma_form.html - Microsoft Internet Explorer 






_|n|x| 


J File 


zd it View Favorites Tools Help 










Back 


- ® ffl 

Stop Refresh Home 


@ m 0 

Search Favorites History 


Mail Print Edit 


Address 


__ http://www.perle.com/suppQrt/rma_forrii.html 








Links B 




PLEASE COMPLETE ALL THE FIELDS. 



RMA FORM 



Return Address Information 

(all fields must be completed) 

Americas _] 



Region: 
Attention: 
Telephone 
Fax: 
Email: 



3 
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Feedback about this manual 

If you have any comments or suggestions for improving this manual please email Perle using the following 
address; 

docfeedback@perle.com 

Please include the title, part number and date of the manual (you can find these on the title page at the 
front of this manual). 
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Perle support centres worldwide 



Note 

Perle offers free technical support to Perle Authorised Distributors and Registered Perle 
Resellers. 

To access technical support please visit the Perle website at www.perle.com/support. 

If you are unable to find the information you require, please feel free to contact our 
technical support teams by email using the addresses shown in the next table. 



Country 


Address 


Email 


North America 


Perle Systems Ltd. 

60 Renfrew Drive 

Markham 

Ontario 

Canada 

L3R 0E1 


Email: ptac@perle.com 


Europe 


Perle Systems Europe Ltd. 
3 Wintersells Road 
Byfleet Surrey 
KT14 7LF 
UK 


Email: ptac@perle.com 


Asia 


Perle Asia Pacific (Pte) Ltd. 
190 Middle Road 
#19-05 Fortune Centre 
Singapore 188979 


Email: ptac@perle.com 


Worldwide 


Perle Systems Ltd. 

60 Renfrew Drive 

Markham 

Ontario 

Canada 

L3R 0E1 


Email: ptac@perle.com 
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Index 

A 

Access Restrictions 111, 188 

account authenticated flag, troubleshooting 228 

ACSII code chart 243-244 

add community 151 

add DNS 151 

add gateway 152 

add host 153 

add modem 153 

add radius 154 

afiW trap 155 

afi«fraVS156 

Adding users 81, 155 

Admin user 87 

admin, cli command 156 

Authentication 
and RADIUS 79 
of username 'admin' 78 
on Rlogin/Telnet into the unit 20 

Automatic baud rate detection 124 

B 

Baud rate 18, 22, 25, 64 

Bi-directional modem connections 44, 219 

Binary to Hex Chart 244 

BOOTP 99-109 

BOOTP file, see BOOTPTAB file 
BOOTPTAB file 102 
Broadcast address 209 
C 

Callback 
fixed 84 
roaming 72 

setting up in a remote Win NT machine 141 
Callback Control Protocol (CBCP) 73 
Change environment 87, 128 
Change password 88, 127 
Change terminal setup 127 



Change user 82 
CHAP 240 

CLI commands 149-217 
cli commands and menu equivalents 149 
cli prompts 87, 124 
CLI, see Command Line Interface 
Command abbreviation 126 
Command Line Interface 126 
contacting Perle Systems 
email 247 

for technical support 248 

internet 247 
C-SLIP, 

overview 237 
customlang feature, see Language Support 
D 

debug 157 
Default settings 

Line 170 

Line, parallel 54 

Line, serial 27, 53, 74 

PPP line 67 

SLIP line 65 

Users 82, 171 
delete community 158 
delete DNS 158 
Delete gateway 159 
Delete host 159 
delete modem 1 60 
delete radius 160 
delete trap 161 
Delete user 89, 161 
delete WINS 162 
Dial parameter 

and line service types 74 
Dialin modem connections 43 
Dialout modem connections 44 
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Direct line service type 

raw 219 

rlogin 219 

telnet 23,219 
DNS 159 
Domain name 209 

Downloadable terminal definitions 96-98 
E 

email 247 

Emergency Recovery 233 

Environment 87, 128 

Error messages, see Troubleshooting 

Ethernet 5 

Examples 

LPD configuration 35 

RCP configuration 41 

SLIP/PPP connections 135 

F 

Factory reset 

software 110 
FLASH memory 27, 54, 75, 93, 165, 168, 173, 
230 

Flow control 18, 22, 25,64 
Forms 125 

FSM, see Full Screen Mode 
Full Screen Mode 124 
G 

Gateway 

configuring using bootp 103 
Global replace 26, 53, 74 
H 

HDLC 237 
heap 162 
Help 126, 162 
Hex Code Chart 244 
Hex to Binary Chart 244 
Host Table 

Show host table 199 
Hot-keys 131-132 



Hunt group 

Bidirectional modems 45 
Dialout modems 44 
Printers 42 
Reverse Telnet 29 

I 

ICMP 66 

Idle timer, see Timers 22 
Initialisation string parameter 

and line service types 74 
Internet address 

Show internet address 209 
IP 235-240 
IP Host 

(default for all users) 1 87 

(setting for a user) 84, 194 
IPCP 239 

ISDN Terminal Adaptors 74 
J 

Joining together two networks 

see Router 
jslogin' line service type 219 
K 

kermit, application 45 
kill line 163 
kill parallel 163 
Kill session 132 
kill session 164 
L 

Language Support 89 

language of your choice 90 

supplied languages 89, 128, 194 

translation guidance 91 
Language support 

effect of Software upgade on ascii Language 
Files 92 

Language Support, customlang, 89, 128, 194 
Line service 

.v.User service 219 
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summary of types 219-221 
Line service types 

Bidirectional 44, 219 
Direct raw 219 
Direct rlogin 23,219 
Direct telnet 23,219 
jslogin 219 

Printer 34-37, 38^10, 220 

Reverse raw 42, 220 

Reverse telnet 220 

Silent raw 221 

Silent rlogin 23, 220 

Silent telnet 23, 220 
Logging on 123 

to remote hosts, see Sessions 
Logging out 128, 164 

from sessions 130 
Lost password 114 
lp, application 45 
LPD 33-37 
M 

Menu system 124 
Menuing 87 
Menus 

cli command equivalents 149 
MIB definitions 116, 117-120 
MIB used by LANSTREAM 115 
Modem name parameter 

and line service types 74 
Modems 

Automatic baud rate detection 74, 124 
Bidirectional 44 

configurable features - summary 74 
Dialin 43 
Dialout 44 
Logging on via 124 
Modem handling 45-53 
MTSD 45-53 

command options 51-53 



Multiple printer connections, see Hunt group 
N 

netload 90, 91, 165 

netload, and the 'save' cli command 173 
Normal user level 87 
Nouser 181 
P 

PAP 240 

Parallel port, configuration 
see LPD or RCP 

see set/show parallel (cli commands) 

Parity 18, 22, 25, 64 

Password 

changes with upgraded software 96 
Changing a user's password 88 
effect of a new configuration file 105, 1 14 
lost 114 

Setting a user's password 81 

users changing their own password 127 
phone number 

when 'dial' is set to 'out' 74 
ping 167 
PPP, 

advantages of 239 

and RADIUS 59 

configuring for a line 67-72 

default line settings 67 

overview 237 

use PPP or SLIP? 62 
Predefined sessions 131 

for other users 87 
Predefining sessions 130 
Print handling (using MTSD) 45-53 
Printer line service type 220 
Printing 

Using LPD 33-37 

Using MTSD 45 

Using RCP 38-40 
Privilege levels, see User level 
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product repair form 25 1 
Prompts, see cli prompts 

Q 

queue types, using LPD 37 
R 

RADIUS 

and telnet/rlogin 20 
and user accounts 78 
class attribute size 81 

line, SLIP and PPP parameters supported 62 

providing SLIP or PPP 59 
RADIUS, example user file 

PPP service 61 

telnet service 81 
RAM 165 
RCP 38-40 

Reboot (cli command) 1 68 
Rebooting 110 
References 241 
Remote client 

setting up using PPP 136 
Remote configuration 111 
Remote printing 

Using LPD 33-37 

Using RCP 38^0 
Remote printing (using MTSD) 45 
repair procedure 251 

product repair form 251 

RMA form 251 
reset factory 1 69 
reset line 170 
reset parallel 170 
Reset to defaults 

Line, parallel 54, 170 

Line, serial 27,53, 74, 170 

Unit 110 

Users 171 
restart 172 

Restricted user level 87 



resume 172 
Resume session 132 
Reverse raw 42, 44, 220 
Reverse telnet 28-29, 220 
RFCs, see References 
RIP 146 

Rlogin23, 129-130, 173,236 
Rlogin, 

and RADIUS 20 

from the unit 17 

into the unit 16 
RMA form 251 
Router 

using the unit as a router 58, 74, 143 
Routes, see show routes 
RS232 signals 74 
S 

Sample terminal definition files 96 
Save configuration 

cli, to a file on a host 1 66 

menus 27, 54, 75, 92 

to a file on a host 113 

to internal memory 173 
save, cli command 1 73 
screen 175 

Screen switch character 131 

Changing a user's 82 
Security 111 

Serial port, configuration 

see Host Control of Ports and Printing Chap- 
ter 31 

see SLIP and PPP Chapter 57 

see Terminal Server Chapter 15 
Server (JETSTREAM or LANSTREAM) base 
unit configuration 209 

Server (JETSTREAM or LANSTREAM) name 
209 

service, user .v. line 83, 219 
Session timer, see Timers 23 
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Sessions 87-88, 128-133 

set contact 175 

set date 176 

set gateway 179 

set host 179 

set line 181 

set location 1 83 

set parallel 1 84 

set radius 186 

set server 1 87 

set telnet 190 

set time 193 

«rfz«er90,91, 193 

Setting a user's password 81 

show date 197 

sAow gateways 198 

show hardware 199 

s/jow hosts 199 

show interfaces 200 

show line 201 

sAow modem 203 

s/iovv parallel 204 

iAow radius 207 

s/iow routes 208 

s/zow serverinfo 209 

s/iovv sessions 210 

s/zow 212 

sAow te/«e? 213,216 

iAow //me 214 

s/zow user 214 

Silent raw 43, 221 

Silent rlogin 20-23, 220 

Silent telnet 20-23 

SLIP, 

and RADIUS 59 

configuring for a line 65-67 

default line settings 65 

deficiencies 236 

overview 235 



use SLIP or PPP? 62 
SNMP 115-122 

add community 151 
add trap 155 
delete community 158 
delete trap 161 

JS8500 Private MIB 1 16, 1 17-120 
set contact 175 
set location 1 83 
start 215 

System administration 95-1 14 
T 

TCP 236 

TCP clear, User service 83 
TCP/IP 5, 236, 237, 240 
technical support 248 

centres worldwide 253 

queries, information needed for 249 

via the internet 250 

who to contact 248 
Telnet 16-29, 129-130, 216, 236 

direct 219 

reverse 28-29, 220 

silent 20-23, 220 
Telnet, 

and RADIUS 20 

from the unit 17 

into the unit 16 

remote sessions - limit on 1 1 1 
Terml/2/3 96 
Terminal definitions 96 
Terminal setup 127 
Terminal type 25, 96, 127 
TFTP 90, 96, 113 
TFTP configuration 98 
Timers 

and logins direct to a host 22 

and Reverse Telnet connections 29 

and Telnet/Rlogin from the unit 19 
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changing for Terminal Server type connec- W 

tions 15 WINS 159 

effect on JETSTREAM or LANSTREAM 
sessions 88 

idle timer, for a line 19, 22, 25, 27, 64, 74 

idle timer, for a user 83 

on Telnet/Rlogin into the unit 16 

session timer, for a line 19, 23, 26, 65 

session timer, for a user 83 
Translating a language file, see Language Sup- 
port 

language of your choice 90 
Traps 116 

Troubleshooting 223-233 
tty interfaces 
and MTSD 45 

U 

UDP 236 
UNIX 5 
Unix SVR4 

dialin under 49 
Unpaged (session) 1 32 
Upgrading software 96 

effect on ascii Language Files 92 
User administration 77-89 
User level 87 
User name 81 
User service 

.v. Line service 83, 219 

TCP clear 83 

tcp clear 81 
User type, see User level 
Users 

default settings 82 
uucp, application 45 
V 

version, cli command 217 
Video pages 

Paged sessions 132 
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